Hey! got a moment? this site uses necessary and functional cookies and similar technologies to make the site work. we also like to set some additional cookies to remember your settings

without some functional cookies, some services might not work

to withdraw consent at any time you can go to the consent manager to edit your choices

i want to manage my choices.

DateApi; the api of Dates on

basic information

The Timetags Api collection is a collection of libraries for a uniform Date api.

The Timetags are for formatting Dates.

note: you can try the JavascriptApi in the browser console

change log

  1. added and overhauled TimeInterval.js and its now in its own class (, )
  2. added _Math_abs, _Math_abs_zroIfNULL and TimeInterval, and changed THE_START to new Date(2024, 5, 19) (, )
  3. removed the Datetime class in the ts api (, )
  4. added [hours?] to mean "[hour24]" (, )
  5. added [DateTimeString] as "[DateString] [TimeString]" (, )

table of [Timetags]

note: (if a '?' is directly after a character it is optional) (case-insensitive)

[Timetag] what it does
[Year2] | [Y2] Year in two digits
[Year4] | [Y4] Year in four digits
[Hour24] | [H2] Hour in 24 clock
[Hour12] | [H1] Hour in 12 clock
[pre0-Hour24] | [0H2] Hour in 24 clock, prefixed by zeros for 2 digits
[pre0-Hour12] | [0H1] Hour in 24 clock, prefixed by zeros for 2 digits
[AM] Uppercase AM or PM
[pm] lower case am or pm
[Minutes?] | [m] Minutes
[seconds?] | [s] seconds
[pre0-Minutes?] | [0m] minutes prefixed with zeros for 2 digits
[pre0-seconds?] | [0s] seconds prefixed with zeros for 2 digits
[DayNumberWeek] | [dnw] day of the week
[DayNumberMonth] | [dnm] | [DayNumber] day of the month
[pre0-DayNumberWeek] | [0dnw] day of the week prefixed by zeros for 2 digits
[pre0-DayNumberMonth] | [0dnm] | [pre0-DayNumber] day of the month prefixed by zeros for 2 digits
[DayName] | [dn] the day's name
[3DayName] | [3dn] the first three letters of the day's name
[MonthName] | [mn] the month's name
[3MonthName] | [3mn] the first three letters of the month's name
[MonthNumber] | [mu] the month's number
[pre0-MonthNumber] | [0mu] the month's number prefixed by zeros for 2 digits
[DayNumberYear] | [DNY] day of the year
[pre0-DayNumberYear] | [0DNY] day of the year prefixed by zeros for 3 digits
[timestamp] | [time] | [ts?] give you the unix timestamp since "Thu, 01 January 1970 00:00:00"
[iso] get an iso timestamp
[tojavascript] same as "[year4]-[pre0-monthNumber]-[pre0-dayNumber]T[pre0-hour24]:[pre0-minutes]:[pre0-seconds]Z"
[DateString] same as "[3dayName] [3MonthName] [pre0-dayNumber] [year4]"
[TimeString] same as "[pre0-hour24]:[pre0-minutes]:[pre0-seconds]"
[DateTimeString] same as "[DateString] [TimeString]"
[toHeader] same as "[3dayname], [pre0-daynumber] [3monthname] [year4] [pre0-hour24]:[pre0-minutes]:[pre0-seconds]"
[toMYSQLi] same as "[year4]-[pre0-monthNumber]-[pre0-dayNumber] [pre0-hour24]:[pre0-minutes]:[pre0-seconds]"
[hours?] same as "[hour24]"