Datetime:format([dateformat], [timeformat])method

Formats the Datetime value as a string.

Parameters

[dateformat]

An optional string representing the format for the date part. For only formatting the time part, use nil in place. The format tokens accepted are :

  • Year : "y" or "yy" for short format of the Year, and "yyyy" for the long format.
  • Month :"M" or "MM" for short format of the Month, and "MMMM" for the long format.
  • Day : "d" or "dd" for short format of the Day, and "dddd" for the long format.

[timeformat]

An optional string representing the format for the time part. For only formatting the date part, omit that argument. The format tokens accepted are :

  • Hours (12-hour clock): "h", or "hh" with a leading zero.
  • Hours (24-hour clock): "H, or "HH" with aleading zero.
  • Minutes :"m" or "mm" with a leading zero.
  • Seconds : "s" or "ss" with a leading zero
  • Time marker : "t or "tt" for AM/PM time marker.

Return value

This function returns the formatted string.

Example

-- get current date and time local today = sys.Datetime() -- prints only the current time, not the date print("Current time = "..today:format(nil, "HH:mm:ss"))