Mathematica 9 is now available
SEARCH MATHEMATICA 8 DOCUMENTATION
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.
Mathematica > Date & Time >
Built-in Mathematica SymbolTutorials »|See Also »|More About »

DateList

DateList[]
gives the current local date and time in the form {year, month, day, hour, minute, second}.
DateList[time]
gives a date list corresponding to an AbsoluteTime specification.
DateList[{y, m, d, h, m, s}]
converts a date list to standard normalized form.
DateList["string"]
converts a date string to a date list.
DateList[{"string", {"e1", "e2", ...}}]
gives the date list obtained by extracting elements "ei" from "string".
  • DateList[] uses whatever date and time have been set on your computer system. It performs no corrections for time zones, daylight saving time, etc.
  • DateList[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.  »
  • All values returned by DateList[] are integers, except the number of seconds. The number of seconds is never more accurate than $TimeUnit.
  • Shorter lists can be used in DateList[{y, m, ...}]: {y} is equivalent to {y, 1, 1, 0, 0, 0}, {y, m} to {y, m, 1, 0, 0, 0}, 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 the form DateList[{"string", {"e1", "e2", ...}] the "ei" can be "Year", "YearShort", "Quarter", "Month", "MonthName", "Day", "DayName", "Hour", "Hour12", "AMPM", "Minute", or "Second".
  • DateList[{"string", {"e1", "e2", ...}] uses the "ei" to fill in elements of {y, m, d, h, m, s}. Those not filled in are taken to have default values {yc, 1, 1, 0, 0, 0}, where yc is the current year.  »
  • In DateList[{"string", {"e1", "e2", ...}], the "ei" are extracted from "string" in the order given, and can be separated by any non-alphanumeric characters.  »
  • DateList[{"string", {"e1", "sep12", "e2", "sep23", ...}] extracts elements using the explicit separators specified.  »
New in 6
© 2013 Wolfram Research, Inc. Japanese
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team