Timestamp to Formatted Date String (utils.date_to_format)

Declaration

date = utils.date_to_format(format, timestamp)

Parameters

• format
  String. Date format.
• timestamp
  Number. Unix timestamp.
• options
  Table. Options.

  {
      tz = "GMT";       -- Timezone. Optional. Default: system timezone. See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
      locale = "en-US"; -- Locale. Optional. Default: root user's locale
  }

Returns

• date
  String. Formatted date string.

Notes

Available after 2025-02-20.

Format Reference

See: Unicode Date Field Symbol Table

Category	Token	Example	Description
Year	yyyy	2024	4-digit year
	yy	24	2-digit year
Month	MMMM	July	Full month name
	MMM	Jul	Abbreviated month
	MM	07	2-digit month
	M	7	1-2 digit month
Day	dd	06	2-digit day
	d	6	1-2 digit day
Weekday	EEEE	Saturday	Full name
	E, EE, EEE	Sat	Abbreviation
	e, ee	7	Localized weekday number (Sun=1, Sat=7)
Hour	HH	15	24h two-digit
	H	15	24h 1-2 digit
	hh	03	12h two-digit
	h	3	12h 1-2 digit
	a	PM	AM/PM
Minute	mm	05	Two-digit minute
	m	5	1-2 digit minute
Second	ss	09	Two-digit second
	S	.1 .12 .123	Milliseconds; count of S sets decimals
Timezone	zzzz	Pacific Daylight Time	Full name
	zzz, z	PDT	Abbreviation
	ZZZZZ	-07:00	ISO 8601 offset with colon
	Z, ZZ, ZZZ	-0700	RFC 822 offset

Examples

nLog(utils.date_to_format("EEE, dd MMM yyyy HH:mm:ss ZZZZ", 1749490800, {tz = "PST"; locale = 'en-US'}))
nLog(utils.date_to_format("EEE, dd MMM yyyy HH:mm:ss ZZZZ", 1749490800, {tz = "PST"; locale = 'zh-CN'}))