DateString

DateString[]
gives a string representing the complete current local date and time.

DateString["elem"]
gives the specified element or format for date and time.

DateString[{"elem1", "elem2", ...}]
concatenates the specified elements in the order given.

DateString[{y, m, d, h, m, s}]
gives a string corresponding to a DateList specification.

DateString[time]
gives a string corresponding to an AbsoluteTime specification.

DateString[spec, elems]
gives elements elems of the date or time specification spec.

Details and OptionsDetails and Options

  • DateString[] by default gives its output in the form specified by $DateStringFormat.
  • The following output elements can be given:
  • "Date"full date
    "DateShort"full date, with short day and month names
    "Time"full time
    "DateTime"full date and time
    "DateTimeShort"full date and time, with short names
    "Year"full year (e.g. 2005)
    "YearShort"2-digit year (e.g. 05)
    "QuarterName"quarter of year (e.g. "Quarter 1")
    "QuarterNameShort"quarter of year in short form (e.g. "Q1")
    "Quarter"quarter number (e.g. 1)
    "MonthName"month name (e.g. "August")
    "MonthNameShort"month name in short form (e.g. "Aug")
    "MonthNameInitial"first letter of month name (e.g. "A")
    "Month"2-digit month number (e.g. 08)
    "MonthShort"1- or 2-digit month number (e.g. 8)
    "DayName"day of the week (e.g. "Wednesday")
    "DayNameShort"day of the week in short form (e.g. "Wed")
    "DayNameInitial"first letter of day name (e.g. "W")
    "Day"2-digit day of the month (e.g. 09)
    "DayShort"1- or 2-digit day of the month (e.g. 9 or 29)
    "Hour"2-digit hour based on system preferences
    "Hour12"2-digit hour on 12-hour clock (e.g. 07)
    "Hour24"2-digit hour on 24-hour clock (e.g. 19)
    "HourShort"1- or 2-digit hour based on system preferences
    "Hour12Short"1- or 2-digit hour on 12-hour clock (e.g. 7)
    "Hour24Short"1- or 2-digit hour on 24-hour clock (e.g. 7, 19)
    "AMPM"AM or PM
    "AMPMLowerCase"am or pm
    "Minute"2-digit minute (e.g. 05)
    "MinuteShort"1- or 2-digit minute (e.g. 5 or 35)
    "Second"2-digit seconds
    "SecondShort"1- or 2-digit seconds
    "SecondExact"seconds including fractions
    "Millisecond"3-digit milliseconds
    "MillisecondShort"1-, 2- or 3-digit milliseconds
  • Any other string given in the list of elements is concatenated literally in the output string.
  • With a typical value for $DateStringFormat, DateString[{y, m, d, h, m, s}] will truncate fractional seconds.
  • Shorter lists can be used in DateString[{y, m, ...}]: {y} is equivalent to , to , etc.
  • Values of m, d, h, m, s outside their normal ranges are appropriately reduced. Non-integer values of d, h, m, s can also be used. »
  • In DateString[spec, elems]the following date and time specifications can be given as spec:
  • timeabsolute time specification
    {y,m,d,h,m,s}DateList specification
    "string"DateString output
    {"string",{"e1","e2",...}}date string formed from specific elements
  • In the form DateString[{"string", {"e1", "e2", ...}, ...] the can be , , , , , , , , , , , or .
  • DateString[{"string", {"e1", "e2", ...}, ...] uses the to fill in elements of . Those not filled in are taken to have default values , where is the current year. »
  • In DateString[{"string", {"e1", "e2", ...}, ...], the are extracted from in the order given, and can be separated by any non-alphanumeric characters. »
  • DateString[{"string", {"e1", "sep12", "e2", "sep23", ...}, ...] extracts elements using the explicit separators specified. »
  • In DateString[spec, elems] the time and date corresponding to spec are by default assumed to be in the time zone specified by $TimeZone, unless spec explicitly specifies another time zone.
  • DateString[spec, elems, TimeZone->z] gives output converted to time zone z.
  • DateString[] uses whatever date and time have been set on your computer system. It performs no corrections for time zones, daylight saving time, etc.
  • DateString[TimeZone -> z] gives the date and time inferred for time zone z by assuming that your computer is set for the time zone specified by $TimeZone. »
New in 6
New to Mathematica? Find your learning path »
Have a question? Ask support »