Formats a time into a string that follows a specific format.
format_time(input: time, format: string) -> string
Description
Section titled “Description”The format_time
function formats the given input
time into a string by using the given format
.
input: time
Section titled “input: time”The input time for which a string should be constructed.
format: string
Section titled “format: string”The string that specifies the desired output format, for example "%m-%d-%Y"
. The
allowed format specifiers are the same as for strftime(3)
:
Specifier | Description | Example |
---|---|---|
%% | A literal % character | % |
%a | Abbreviated or full weekday name | Mon , Monday |
%A | Equivalent to %a | Mon , Monday |
%b | Abbreviated or full month name | Jan , January |
%B | Equivalent to %b | Jan , January |
%c | Date and time representation | Mon Jan 1 12:00:00 2024 |
%C | Century as a decimal number | 20 |
%d | Day of the month with zero padding | 01 , 31 |
%D | Equivalent to %m/%d/%y | 01/31/24 |
%e | Day of the month with space padding | 1 , 31 |
%F | Equivalent to %Y-%m-%d | 2024-01-31 |
%g | Last two digits of ISO week-based year | 24 |
%G | ISO week-based year | 2024 |
%h | Equivalent to %b | Jan |
%H | Hour in 24-hour format | 00 , 23 |
%I | Hour in 12-hour format | 01 , 12 |
%j | Day of year | 001 , 365 |
%m | Month number | 01 , 12 |
%M | Minutes | 00 , 59 |
%n | Newline character | \n |
%p | AM/PM designation | AM , PM |
%r | 12-hour clock time | 12:00:00 PM |
%R | Equivalent to %H:%M | 23:59 |
%S | Seconds | 00 , 59 |
%t | Tab character | \t |
%T | Equivalent to %H:%M:%S | 23:59:59 |
%u | ISO weekday (Monday=1) | 1 , 7 |
%U | Week number (Sunday as first day) | 00 , 52 |
%V | ISO week number | 01 , 53 |
%w | Weekday (Sunday=0) | 0 , 6 |
%W | Week number (Monday as first day) | 00 , 52 |
%x | Date representation | 01/31/24 |
%X | Time representation | 23:59:59 |
%y | Year without century | 24 |
%Y | Year with century | 2024 |
%z | UTC offset | +0000 , -0430 |
%Z | Time zone abbreviation | UTC , EST |
Examples
Section titled “Examples”Format a timestamp
Section titled “Format a timestamp”from { x: 2024-12-31T12:59:42,}x = x.format_time("%d.%m.%Y")
{x: "31.12.2024"}