formatstring
Формат выходного времени, который может быть предопределённым форматом или пользовательским макетом.
## Предопределённые форматы
ANSIC, Rubydate, RFC822, RFC1123, Unixdate, Kitchen, StampMilli, DateTime, DateOnly, RFC850, RFC1123z, RFC3339nano, Stamp, RFC822z, RFC3339, StampMicro, StampNano, TimeOnly
## Пользовательский формат
Пользовательский формат можно собрать из следующих компонентов. Каждый компонент показывает пример того, как форматируется часть эталонного времени. Распознаются только эти значения. Любой текст в строке макета, не распознанный как компонент, считается литералом.
- Год: "2006", "06"
- Месяц: "Jan", "January", "01", "1"
- День недели: "Mon", "Monday"
- День месяца: "2", "_2", "02"
- День года: "__2", "002"
- Час: "15", "3", "03" (PM или AM)
- Минута: "4", "04"
- Секунда: "5", "05"
- Метка AM/PM: "PM"
### Числовые смещения часового пояса
- "-0700" (±hhmm)
- "-07:00" (±hh:mm)
- "-07" (±hh)
- "-070000" (±hhmmss)
- "-07:00:00" (±hh:mm:ss)
Замена знака на "Z" запускает поведение ISO 8601, при котором для зоны UTC выводится "Z":
- "Z0700" (Z или ±hhmm)
- "Z07:00" (Z или ±hh:mm)
- "Z07" (Z или ±hh)
- "Z070000" (Z или ±hhmmss)
- "Z07:00:00" (Z или ±hh:mm:ss)
В строке формата подчёркивания в "_2" и "__2" обозначают пробелы, которые могут заменяться цифрами, если следующее число состоит из нескольких цифр, для совместимости с Unix-форматами времени фиксированной ширины. Ведущий ноль означает значение, дополненное нулями.
Форматы __2 и 002 - это день года из трёх символов, дополненный пробелами и нулями; формата дня года без дополнения нет.
### Доли секунды
Запятая или десятичная точка, за которой идёт один или несколько нулей, обозначает долю секунды, выводимую с заданным числом знаков после запятой. Запятая или десятичная точка, за которой идёт одна или несколько девяток, обозначает долю секунды с удалёнными конечными нулями.
Например, "15:04:05.000" форматирует или разбирает с точностью до миллисекунд.
timezonestring
Целевой часовой пояс для вывода, в формате IANA (например, 'America/New_York').