Format Dates with the "format" function ♦

NimbleText helps you write dates in whatever format you want.

You want to say "Sat, 21st Dec 2024." you use a pattern like this:

<% (new Date()).format("ddd, ddS MMM yyyy.") %>

with result:

Sat, 21st Dec 2024.

Note: while the format function converts a Date into a string, the reverse is also possible! Use the toDate function to turn any string into a date.

(Read this article to convert a string into a date)

The format function has two optional parameters, the mask and a boolean to indicate UTC (or not).

Mask Specifiers for the format function

Here's a description of all the mask specifiers you can use for formatting a date:

Named Masks

There are also some named masks that you can use. These are not currently configurable. If you'd like to be able to edit the defined masks used by these masks, it can be included in a future version of NimbleText. You need only ask.

♦ This feature is only available in the Desktop version. (Compare versions).

Here are some useful formats that I need to check the support for

Acknowledgement and Thanks

This functionality is provided by Steven Levithan's excellent Date-time format library. The main underlying difference is that in NimbleText capital 'M' is used for month, while lower-case 'm' for minutes (instead of the opposite); this is done for consistency with C# (and dotnet in general) where myself and many of my customers are most familiar.

The documentation above is based on the original JavaScript Date Format Documentation from Steven Levithan with some changes, so errors are all mine.

Steven is also the author of the cross-browser split function which is used by NimbleText. He co-authored O'Reilly's Regular Expressions Cookbook (now in its second edition) so I think you should go and buy that.

Internationalization

Note that internationalization can also be achieved (though I don't have any special feature to make this smoother, yet)

As described by Steven Levithan here, you can specify the substrings used for parts of dates, like so:

<%
dateFormat.i18n = {
  dayNames: [
    "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat",
    "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"
  ],
  monthNames: [
    "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
    "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"
  ]
}; %>

xkcd/1179 (also see Doeke Zanstra's live clock based on this XKCD cartoon, and xkcd/now)

Further help

You can also get general help, help on all the symbols and keywords, or on the built-in functions, filtering with a where clause, help with the powerful command-line automation, or applying custom formats to your dates and times.

• General help
• Symbols and Keywords
• Built-in Functions
• The 'Where' clause
• Date Time formatting
• Date Time parsing
• Command-Line Automation
• SQL Master Class
• HTML Master Class
• Popular Text Manipulations Made Easy «« bookmark this one

You need to purchase a license to unlock all the features in NimbleText.

If you haven't downloaded NimbleText yet, then for added power, privacy and versatility I sincerely think you should download it now.