Topics

All topics

Setup and maintenance

    Configure the date and time format

    This article contains
    NEW TO SITEFINITY?

    Date and time calculation

    On the frontend, Sitefinity CMS supports the following ways for calculating date and time:

    • Calculate the date and time server-side
      This is the default behavior. 
      All the dates are rendered according to the current culture of the page and the time zone of the current site in Sitefinity CMS. 

      By default, the date and time formats used by the date and time fields are h:mm a and M/dd/yyyy for time and date, respectively.

    • Calculate the date and time client-side
      The date and time can also be calculated on the client, using the client browsers time zone information.

    Modify date and time calculation and format

    You change the date and time settings by modifying the config.json file, located in the ~\SitefinityWebApp\AdminApp\ folder:

    You do this by modifying the dateTimeFormat object, which has the following properties:

    {
    "dateTimeFormat": {
    "useBrowserLocale": true,
    "browserLocaleFormatWidth": "long",
    "timeFormat": "HH:mm",
    "dateFormat": "d/MMM/yyyy"
    }
    }
    view raw DateTimeAdminApp.json hosted with ❤ by GitHub

    You can configure the following:

    useBrowserLocale

    By default, this property is set to false, which means that the date and time are calculated server-side.

    If you set it to true, then date and time is calculated client-side.

    browserLocaleFormatWidth 

    This property can be short, medium or long.
    If this property is not provided and useBrowserLocale is true, it defaults to short.

    timeFormat

    This property accepts the following values:

    "H:mm", // 21:15 (no leading zero for the hour)
    "HH:mm", // 21:15
    "H:mm:ss", // 21:15:00 (no leading zero for the hour)
    "HH:mm:ss", // 21:15:00
    "h:mm a", // 9:15 PM (no leading zero for the hour)
    "hh:mm a", // 09:15 PM
    "h:mm:ss a", // 9:15:00 PM (no leading zero for the hour)
    "hh:mm:ss a" // 09:15:00 PM
    view raw TimeFormat.txt hosted with ❤ by GitHub

    dateFormat

    This property accepts the following values:

    "yyyy-MM-dd", // 2000-11-06, ISO 8601
    "yyyy/MM/dd", // 2000/11/06
    "yyyy.MM.dd", // 2000.11.06
    "yyyy MM dd", // 2000 11 06
    "yyyy/M/d", // 2000/11/06 (no leading zero for the day and month)
    "yyyy-M-d", // 2000-11-06 (no leading zero for the day and month)
    "yyyy/M.d", // 2000.11.06 (no leading zero for the day and month)
    "yyyy M d", // 2000 11 06 (no leading zero for the day and month)
    "dd/MM/yyyy", // 06/11/2000
    "dd-MM-yyyy", // 06-11-2000
    "dd.MM.yyyy", // 06.11.2000
    "dd MM yyyy", // 06 11 2000
    "d/M/yyyy", // 6/11/2000 (no leading zero for the day and month)
    "d-M-yyyy", // 6-11-2000 (no leading zero for the day and month)
    "d.M.yyyy", // 6.11.2000 (no leading zero for the day and month)
    "d M yyyy", // 6 11 2000 (no leading zero for the day and month)
    "M/d/yyyy", // 11/6/2000 (no leading zero for the day and month)
    "M-d-yyyy", // 11-6-2000 (no leading zero for the day and month)
    "M.d.yyyy", // 11.6.2000 (no leading zero for the day and month)
    "M d yyyy", // 11 6 2000 (no leading zero for the day and month)
    "MM/dd/yyyy", // 11/06/2000
    "MM-dd-yyyy", // 11-06-2000
    "MM.dd.yyyy", // 11.06.2000
    "MM dd yyyy", // 11 06 2000
    "yy-MM-dd", // 00-11-06, ISO 8601
    "yy/MM/dd", // 00/11/06
    "yy.MM.dd", // 00.11.06
    "yy MM dd", // 00 11 06
    "yy/M/d", // 00/11/06 (no leading zero for the day and month)
    "yy-M-d", // 00-11-06 (no leading zero for the day and month)
    "yy/M.d", // 00.11.06 (no leading zero for the day and month)
    "yy M d", // 00 11 06 (no leading zero for the day and month)
    "dd/MM/yy", // 06/11/00
    "dd-MM-yy", // 06-11-00
    "dd.MM.yy", // 06.11.00
    "dd MM yy", // 06 11 00
    "d/M/yy", // 6/11/00 (no leading zero for the day and month)
    "d-M-yy", // 6-11-00 (no leading zero for the day and month)
    "d.M.yy", // 6.11.00 (no leading zero for the day and month)
    "d M yy", // 6 11 00 (no leading zero for the day and month)
    "M/d/yy", // 11/6/00 (no leading zero for the day and month)
    "M-d-yy", // 11-6-00 (no leading zero for the day and month)
    "M.d.yy", // 11.6.00 (no leading zero for the day and month)
    "M d yy", // 11 6 00 (no leading zero for the day and month)
    "MM/dd/yy", // 11/06/00
    "MM-dd-yy", // 11-06-00
    "MM.dd.yy", // 11.06.00
    "MM dd yy", // 11 06 00
    "d MMM yyyy", // 6 Nov 2000 (no leading zero for the day)
    "d-MMM-yyyy", // 6-Nov-2000 (no leading zero for the day)
    "MMM d yyyy", // Nov 6 2000 (no leading zero for the day)
    "MMM-d-yyyy" // Nov-6-2000 (no leading zero for the day)
    view raw DateFormat.txt hosted with ❤ by GitHub
    EXAMPLE: Example behavior of useBrowserLocale, if the browser's language is English (US).
    • If the browserLocaleFormatWidth is set to long, the formats used in the date and time field will be "h:mm:ss a" and "MMMM d, y", which looks like 9:22:13 am and July 10, 2021.
    • If the browserLocaleFormatWidth is set to medium, the formats used in the date and time field will be "h:mm:ss a" and "MMM d, y", which looks like 9:22:13 am and Jul 10, 2021.
    • If the browserLocaleFormatWidth is set to shor,t the formats used in the date and time field will be "h:mm a" and "M/d/yy", which will look like 9:22 AM and 7/10/2021.

    Want to learn more?

    Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

    Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

    This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

    Web Security for Sitefinity Administrators

    This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

    Foundations of Sitefinity ASP.NET Core Development

    The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

    Was this article helpful?

    Next article

    Enable formatting options when posting on forums