Строки стандартного формата даты и времени

Статья
10/24/2024

Стандартная строка формата даты и времени использует один символ в качестве описателя формата для определения текстового представления значения времени и даты. Любая строка формата даты и времени, содержащая более одной буквы, включая пробелы, интерпретируется как строка пользовательского формата даты и времени. Стандартная или настраиваемая строка форматирования может использоваться для определения текстового представления, которое приводит к выполнению операции форматирования.

Таблица описателей формата

В следующей таблице описаны спецификаторы стандартных форматов даты и времени.

Спецификатор формата	Description	Примеры
"d"	Короткий шаблон даты. Дополнительные сведения: описатель формата short date (d).	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Полный шаблон даты. Дополнительные сведения: описатель формата длинной даты (D).	2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Монтаг, 15. Juni 2009 (de-DE)
"f"	Полный шаблон даты и времени (короткий шаблон времени). Дополнительные сведения: описатель формата полной даты (f).	2009-06-15T13:45:30 -> понедельник, 15 июня 2009 1:45 вечера (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Ππέπα, 15 Παπ 2009 1:45 μμ (el-GR)
"F"	Полный шаблон даты и времени (полный шаблон времени). Дополнительные сведения: описатель формата полной даты (F).	2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. 1:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Πππέπα, 15 Παπ 2009 1:45:30 μμ (el-GR)
"g"	Общий шаблон даты и времени (короткий шаблон времени). Дополнительные сведения: общий описатель формата даты ("g").	2009-06-15T13:45:30 -> 6/15/2009 1:45 ВЕЧЕРА (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Общий шаблон даты и времени (полный шаблон времени). Дополнительные сведения: общий описатель формата даты ("G").	2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Шаблон дней месяца. Дополнительные сведения: описатель формата "M", "m").	2009-06-15T13:45:30 -> 15 июня (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	Шаблон обратного преобразования даты и времени. Дополнительные сведения: описатель формата "O", "o").	2009-06-15T13:45:30 (Локальный) -> 2009-06-15T13:45:30.0000000-07:000 2009-06-15T13:45:30 (UTC) -> 2009-06-15T13:45:30.0000000+0000+000:00 2009-06-15T13:45:30 (Не определено) -> 2009-06-15T13:45:30.0000000
"R", "r"	Шаблон RFC1123. Дополнительные сведения: описатель формата RFC1123 ("R", "r").	2009-06-15T13:45:30 -> Mon, 15 июня 2009 13:45:30 GMT
"s"	Сортируемый шаблон времени и даты. Дополнительные сведения: описатель формата сортировки ("s").	2009-06-15T13:45:30 (локальный) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (UTC) -> 2009-06-15T13:45:30
"t"	Короткий шаблон времени. Дополнительные сведения: описатель формата "t") в коротком времени.	2009-06-15T13:45:30 -> 1:45 PM (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 Гс (ar-EG)
"T"	Полный шаблон времени. Дополнительные сведения: описатель формата длительного времени (T).	2009-06-15T13:45:30 -> 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 ГС (ar-EG)
"u"	Универсальный сортируемый шаблон времени и даты. Дополнительные сведения: описатель универсального формата сортировки (u).	2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z
"Y", "y"	Шаблон месяца года. Дополнительные сведения: описатель формата года ("Y") .	2009-06-15T13:45:30 -> июнь 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Любой другой символ	Неизвестный описатель.	Вызывает ошибку выражения во время выполнения.

Как работают строки стандартного формата

В операции форматирования строка стандартного формата — это всего лишь псевдоним для строки пользовательского формата. Преимуществом использования псевдонима для ссылки на строку пользовательского формата является то, что при изменении строки пользовательского формата псевдоним может оставаться неизменным. Это важно, поскольку строковые представления значений даты и времени обычно зависят от региональных параметров. Например, строка стандартного формата "d" указывает, что значение даты и времени будет отображаться с использованием шаблона короткого формата даты. Для инвариантных региональных параметров таким шаблоном является "мм/дд/гггг". Для региональных параметров fr-FR это "дд/мм/гггг". Для региональных параметров ja-JP это "гггг/мм/дд".

Если строка стандартного формата в операции форматирования сопоставлена со строкой пользовательского формата для определенных региональных параметров, то приложение может определить конкретные региональные параметры, для которых строки пользовательского формата используются одним из следующих способов:

Можно использовать региональные параметры по умолчанию (или текущие). Следующий пример отображает дату в формате короткой даты, соответствующем текущим региональным параметрам. В этом случае текущими региональными параметрами являются en-US.
```
let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d"])
        //Displays 3/15/2024
    }
in
    Source
```
Вы можете передать язык и региональные параметры, используемые для форматирования даты в соответствии с правилами этого конкретного языка и региональных параметров. Следующий пример отображает дату в формате короткой даты, соответствующем региональным параметрам pt-BR.
```
let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d", Culture = "pt-BR"])
        //Displays 15/03/2024
   }
in
    Source
```

В некоторых случаях строка стандартного формата служит удобным сокращением длинной строки пользовательского формата, который является неизменяемым. В эту категорию попадают четыре строки стандартного формата: "O" (или "o"), "R" (или "r"), "s" и "u". Эти строки соответствуют строкам пользовательского формата, соответствующего инвариантным региональным параметрам. Они создают строковые представления значений даты и времени, которые, предположительно, совпадают для различных региональных параметров. В следующей таблице приведены сведения об этих четырех строках стандартных форматов даты и времени.

Строка стандартного формата	Определяется по	Строка пользовательского формата
"O" или "o"	нет	гггг'-'ММ'-dd'T'HH':'mm'ss'. fffffffK
"R" или "r"	Спецификация IETF RFC 1123	ддд, дд ммм гггг чч':'мм':'сс 'GMT'
"s"	ISO 8601	гггг'-'мм'-'дд'T'чч':'мм':'сс
"u"	Сортируемый, так как он использует начальные нули в течение года, месяца, дня, часа, минуты и секунды	гггг'-'мм'-'дд чч':'мм':'сс'Z'

Строки стандартного формата также можно использовать в операциях синтаксического анализа, которые требуют, чтобы входная строка точно соответствовала определенному шаблону для успешной операции синтаксического анализа. Многие строки стандартного формата сопоставляются с несколькими настраиваемыми строками форматирования, поэтому значение даты и времени может быть представлено в различных форматах, и операция синтаксического анализа по-прежнему завершается успешно.

В следующих разделах описаны стандартные описатели формата для значений Date, DateTime, DateTimeZone и Time .

Форматы даты

Эта группа содержит следующие форматы:

Описатель краткого формата даты ("d").
Описатель полного формата даты ("D").

Описатель краткого формата даты ("d").

Описатель стандартного формата "d" представляет настраиваемый формат даты, определенный определенным языком и региональными параметрами. Например, текст настраиваемого формата, возвращаемый инвариантным языком и региональными параметрами, — MM/dd/гггг.

В следующем примере для отображения значения даты используется описатель формата "d".

let
    Source =
    {
        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = ""]),
        // Displays 04/10/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-US"]),
        // Displays 4/10/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-NZ"]),
        // Displays 10/4/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "de-DE"])
        // Displays 10.4.2024
    }
in
    Source

К таблице

Описатель полного формата даты ("D").

Описатель стандартного формата D представляет настраиваемый формат даты, определенный определенным языком и региональными параметрами. Например, строкой пользовательского формата для инвариантных региональных параметров является "дддд, дд мммм гггг".

В следующем примере описатель формата "D" используется для отображения значения даты и времени.

let
    Source =
    {
        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = ""]),
        // Displays Wednesday, 10 April, 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "pt-BR"]),
        // Displays quarta-feira, 10 de abril de 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "es-MX"])
        // Displays miércoles, 10 de abril de 2024
    }
in
    Source

К таблице

Форматы даты и времени

Эта группа содержит следующие форматы:

Описатель полного формата даты и краткого формата времени ("f").
Описатель полного формата даты и полного формата времени ("F").
Описатель общего формата даты и краткого формата времени ("g").
Описатель общего формата даты и полного формата времени ("G").
Описатель формата обратного преобразования ("O", "o").
Описатель формата RFC1123 ("R", "r").
Описатель сортируемого формата ("s").
Описатель универсального сортируемого формата ("u").

Описатель полного формата даты и краткого формата времени ("f").

Описатель стандартного формата "f" представляет сочетание полного формата даты ("D") и короткого формата времени ("t"), разделенных пробелом.

Строка результатов зависит от сведений о форматировании определенного языка и региональных параметров.

В следующем примере описатель формата "f" используется для отображения значения даты и времени.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "fr-FR"])
        // Displays mercredi 10 avril 2024 06:30
    }
in
    Source

К таблице

Описатель полного формата даты и полного формата времени ("F").

Описатель стандартного формата "F" представляет настраиваемый формат даты и времени, определенный определенным языком и региональными параметрами. Например, строкой пользовательского формата для инвариантных региональных параметров является "дддд, дд мммм гггг чч:мм:сс".

Строка результатов зависит от сведений о форматировании определенного языка и региональных параметров.

В следующем примере описатель формата "F" используется для отображения значения даты и времени.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = ""]),
        // Displays Wednesday, 10 April, 2024 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "fr-FR"])
        // Displays mercredi 10 avril 2024 06:30:00
    }
in
    Source

К таблице

Описатель общего формата даты и краткого формата времени ("g").

Описатель стандартного формата "g" представляет сочетание краткого формата даты ("d") и краткого формата времени ("t"), разделенных пробелом. Результирующий текст зависит от сведений о форматировании определенного языка и региональных параметров.

Строка результатов зависит от сведений о форматировании определенного языка и региональных параметров.

В следующем примере описатель формата "g" используется для отображения значения даты и времени.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = ""]),
        // Displays 04/10/2024 06:30

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "en-US"]),
        // Displays 4/10/2024 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "fr-BE"])
        // Displays 10-04-24 06:30
    }
in
    Source

К таблице

Описатель общего формата даты и полного формата времени ("G").

Описатель стандартного формата "G" представляет сочетание краткого формата даты ("d") и полного формата времени ("T"), разделенных пробелом. Результирующий текст зависит от сведений о форматировании определенного языка и региональных параметров.

Строка результатов зависит от сведений о форматировании определенного языка и региональных параметров.

В следующем примере описатель формата "G" используется для отображения значения даты и времени.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = ""]),
        // Displays 04/10/2024 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "en-US"]),
        // Displays 4/10/2024 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "nl-BE"])
        // Displays 10/04/2024 6:30:00
    }
in
    Source

К таблице

Описатель формата обратного преобразования ("O", "o").

Описатель формата обратного преобразования ("O", "o") представляет строку настраиваемого формата даты и времени, используя шаблон, который сохраняет данные о часовом поясе и возвращает строковое значение, соответствующее стандарту ISO 8601. Для значений DateTimeZone этот описатель формата предназначен для сохранения значений даты, времени и часового пояса в тексте.

Описатель стандартного формата "O" или "o" соответствует "гггг'-мм'-дд'T'HH':'mm'ss". fffffffxxx" — настраиваемая строка форматирования для значений DateTimeZone . В этом тексте пары отдельных кавычки, разделяющие отдельные символы, такие как дефисы, двоеточия и буква "T", указывают, что отдельный символ является литеральным, который нельзя изменить. Апострофы не отображаются в выходной строке.

Описатель стандартного формата "O" или "o" (и "гггг'-мм'-'dd'T'HH':'mm'ss'". fffffffffxx", настраиваемый формат) использует способы, которыми ISO 8601 представляет сведения часового пояса для сохранения значений DateTimeZone:

Компонент часового пояса DateTimeZone.ToLocal значения даты и времени — смещение от UTC (например, +01:00, -07:00).
Компонент часового пояса DateTimeZone.ToUtc значения даты и времени использует +00,00 для представления UTC.

Так как стандартный описатель формата "O" и "o" соответствует международному стандарту, операция форматирования или синтаксического анализа, использующая описатель, всегда использует инвариантный региональный параметр и григорианский календарь.

В следующем примере используется описатель формата O для отображения ряда значений DateTimeZone в системе в тихоокеанском часовом поясе США.

let
    date1 = #datetimezone(2024, 6, 15, 13, 45, 30, 0, 0),
    Source =
    {
        Text.Format("#{0} (Unspecified) --> #{1}", {date1, DateTimeZone.ToText(date1, [Format = "O"])}),
        Text.Format("#{0} (Utc) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToUtc(date1), [Format = "O"])}),
        Text.Format("#{0} (Local) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToLocal(date1), [Format = "O"])})
    }
in
    Source

// The example displays the following output:
//    6/15/2024 1:45:30 PM +00:00 (Unspecified) --> 2024-06-15T13:45:30.0000000+00:00
//    6/15/2024 1:45:30 PM +00:00 (Utc) --> 2024-06-15T13:45:30.0000000+00:00
//    6/15/2024 1:45:30 PM +00:00 (Local) --> 2024-06-15T08:45:30.0000000-07:00

Примечание.

Значение, возвращаемое DateTimeZone.ToLocal, зависит от того, выполняется ли Power Query на локальном компьютере или в сети. Например, в приведенном выше примере в системе в часовом поясе США в тихоокеанском часовом поясе Power Query Desktop возвращается для -07:00 времени, так как он считывает время, заданное на локальном компьютере. Однако Power Query Online возвращается, так как он считывает +00:00 время, заданное на облачных виртуальных машинах, которые имеют значение UTC.

В следующем примере используется описатель формата O для создания форматируемой строки, а затем восстанавливает исходное значение даты и времени путем вызова подпрограммы анализа даты и времени.

let
    // Round-trip a local time
    #"Origin Local Date" = DateTimeZone.ToLocal(
        #datetimezone(2024, 4, 10, 6, 30, 0, 0, 0)
    ),
    #"Local Date Text" = DateTimeZone.ToText(
        #"Origin Local Date", [Format = "o"]
    ),
    #"New Local Date" = DateTimeZone.FromText(#"Local Date Text"),
    #"Local Round Trip" = Text.Format(
        "Round-tripped #{0} Local to #{1} Local.", 
        {
            DateTimeZone.ToText(#"Origin Local Date"), 
            DateTimeZone.ToText(#"New Local Date")
        }
    ),

    // Round-trip a UTC time
    #"Origin UTC Date" = DateTimeZone.ToUtc(
        #datetimezone(2024, 4, 12, 9, 30, 0, 0, 0)
    ),
    #"UTC Date Text" = DateTimeZone.ToText(
        #"Origin UTC Date", [Format = "o"]
    ),
    #"New UTC Date" = DateTimeZone.FromText(#"UTC Date Text"),
    #"UTC Round Trip" = Text.Format(
        "Round-tripped #{0} UTC to #{1} UTC.", 
        {
            DateTimeZone.ToText(#"Origin UTC Date"), 
            DateTimeZone.ToText(#"New UTC Date")
        }
    ),

    // Round-trip an 18 hour offset time
    #"Origin Offset Date" = DateTimeZone.ToLocal(
        #datetimezone(2024, 4, 10, 6, 30, 0, 0, 0) + #duration(0, 18, 0, 0)
    ),
    #"Offset Date Text" = DateTimeZone.ToText(
        #"Origin Offset Date", [Format = "o"]
    ),
    #"New Offset Date" = DateTimeZone.FromText(#"Offset Date Text"),
    #"Offset Round Trip" = Text.Format(
        "Round-tripped #{0} to #{1}.", 
        {
            DateTimeZone.ToText(#"Origin Offset Date"), 
            DateTimeZone.ToText(#"New Offset Date")
        }
    ),

    #"Round Trip Results" = 
        {#"Local Round Trip", #"UTC Round Trip", #"Offset Round Trip"}
in
    #"Round Trip Results"

// The example displays the following output in Power Query Desktop:
//    Round-tripped 4/9/2024 11:30:00 PM -07:00 Local to 4/9/2024 11:30:00 PM -07:00 Local.
//    Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
//    Round-tripped 4/10/2024 5:30:00 PM -07:00 to 4/10/2024 5:30:00 PM -07:00.

// The example displays the following output in Power Query Online:
//    Round-tripped 4/10/2024 6:30:00 AM +00:00 Local to 4/10/2024 6:30:00 AM +00:00 Local.
//    Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
//    Round-tripped 4/11/2024 12:30:00 AM +00:00 to 4/11/2024 12:30:00 AM +00:00.

К таблице

Описатель формата RFC1123 ("R", "r").

Описатель стандартного формата "R" или "r" представляет настраиваемую строку формата даты и времени, которая не определена определенным языком и региональными параметрами. Он всегда совпадает, независимо от используемого языка и региональных параметров или предоставленного поставщика формата. Строкой пользовательского формата является "ддд, дд ммм гггг чч':'мм':'сс 'GMT'". Когда используется этот спецификатор стандартного формата, операция форматирования или разбора всегда использует инвариантные региональные параметры.

Хотя стандарт RFC 1123 выражает время в формате UTC, операция форматирования не изменяет значение даты и времени форматирования, которое отформатировано. Поэтому необходимо преобразовать значение DateTime в UTC, вызвав метод функции DateTimeZone.ToUtc перед выполнением операции форматирования.

В следующем примере используется описатель формата R для отображения значения времени и даты в системе в часовом поясе США (семь часов за utc).

let
    date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
    dateOffset = DateTimeZone.ToUtc(date1),
    Source = 
    {
        DateTimeZone.ToText(date1, [Format = "r"]),
        // Displays Wed, 10 Apr 2024 13:30:00 GMT

        DateTimeZone.ToText(dateOffset, [Format = "r"])
        // Displays Wed, 10 Apr 2024 13:30:00 GMT
    }
in
    Source

К таблице

Описатель сортируемого формата ("s").

Описатель стандартного формата "s" представляет настраиваемую строку формата даты и времени, которая отражает определенный стандарт (ISO 8601) и доступен только для чтения. Таким образом, оно не изменяется в зависимости от используемых региональных параметров или предоставленного поставщика формата. Строкой пользовательского формата является "гггг'-'мм'-'дд'T'чч':'мм':'сс". Описатель формата "s" предназначен для создания строк результатов, согласованно отсортированных по возрастанию или убыванию на основе значений даты и времени.

Когда используется этот спецификатор стандартного формата, операция форматирования или разбора всегда использует инвариантные региональные параметры.

В следующем примере используется описатель формата "s" для отображения значения даты и времени в системе в тихоокеанском часовом поясе США.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "s", Culture = "en-US"])
        // Displays 2024-04-10T06:30:00
    }
in
    Source

К таблице

Описатель универсального сортируемого формата ("u").

Описатель стандартного формата u представляет настраиваемую строку формата даты и времени, которая всегда совпадает с языком и региональными параметрами или предоставленным поставщиком формата. Строкой пользовательского формата является "гггг'-'мм'-'дд чч':'мм':'сс'Z'". Шаблон отражает определенный стандарт. Свойство предназначено только для чтения. Когда используется этот спецификатор стандартного формата, операция форматирования или разбора всегда использует инвариантные региональные параметры.

Хотя результирующая строка должна выразить время в формате UTC, во время операции форматирования не выполняется преобразование исходного значения DateTimeZone . Поэтому необходимо преобразовать значение DateTimeZone в формате UTC, вызвав функцию DateTimeZone.ToUtc перед форматированием.

В следующем примере описатель формата "u" используется для отображения значения даты и времени.

let
    date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
    dateOffset = DateTimeZone.ToUtc(date1),
    Source =
    {
        DateTimeZone.ToText(dateOffset, [Format = "u"]),
        // Displays 2024-04-10 13:30:00Z
    }
in
    Source

К таблице

Форматы времени

Эта группа содержит следующие форматы:

Описатель краткого формата времени ("t").
Описатель полного формата времени ("T").

Описатель краткого формата времени ("t").

Описатель стандартного формата t представляет настраиваемую строку формата даты и времени, определяемую указанным языком и региональными параметрами. Например, строкой пользовательского формата для инвариантных региональных параметров является "чч:мм".

Строка результатов зависит от сведений о форматировании определенного языка и региональных параметров.

В следующем примере описатель формата "t" используется для отображения значения даты и времени.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = ""]),
        // Displays 06:30
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "en-US"]),
        // Displays 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "es-ES"])
        // Displays 6:30
    }
in
    Source

К таблице

Описатель полного формата времени ("T").

Описатель стандартного формата "T" представляет настраиваемую строку формата даты и времени, определяемую определенным языком и региональными параметрами. Например, строкой пользовательского формата для инвариантных региональных параметров является "чч:мм:сс".

В следующем примере описатель формата "T" используется для отображения значения даты и времени.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = ""]),
        // Displays 06:30:00
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "en-US"]),
        // Displays 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "es-ES"])
        // Displays 6:30:00
    }
in
    Source

К таблице

Частичные форматы даты

Эта группа содержит следующие форматы:

Описатель формата месяца ("M", "m").
Описатель формата месяца года ("Y", "y").

Описатель формата месяца ("M", "m").

Описатель стандартного формата "M" или "m" представляет настраиваемую строку формата даты и времени, определяемую определенным языком и региональными параметрами. Например, строкой пользовательского формата для инвариантных региональных параметров является "мммм дд".

В следующем примере описатель формата "m" используется для отображения значения даты и времени.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = ""]),
        // Displays April 10
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "en-US"]),
        // Displays April 10

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "ms-MY"])
        // Displays 10 April
    }
in
    Source

К таблице

Описатель формата месяца года ("Y", "y").

Описатель стандартного формата "Y" или "y" представляет строку настраиваемого формата даты, определяемую определенным языком и региональными параметрами. Например, строкой пользовательского формата для инвариантных региональных параметров является "гггг мммм".

В следующем примере описатель формата "y" используется для отображения значения даты и времени.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = ""]),
        // Displays 2024 April
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = "en-US"]),
        // Displays April 2024

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "y", Culture = "af-ZA"])
        // Displays April 2024
    }
in
    Source

К таблице

Поделиться через

Строки стандартного формата даты и времени

Таблица описателей формата

Как работают строки стандартного формата

Форматы даты

Описатель краткого формата даты ("d").

Описатель полного формата даты ("D").

Форматы даты и времени

Описатель полного формата даты и краткого формата времени ("f").

Описатель полного формата даты и полного формата времени ("F").

Описатель общего формата даты и краткого формата времени ("g").

Описатель общего формата даты и полного формата времени ("G").

Описатель формата обратного преобразования ("O", "o").

Описатель формата RFC1123 ("R", "r").

Описатель сортируемого формата ("s").

Описатель универсального сортируемого формата ("u").

Форматы времени

Описатель краткого формата времени ("t").

Описатель полного формата времени ("T").

Частичные форматы даты

Описатель формата месяца ("M", "m").

Описатель формата месяца года ("Y", "y").

Обратная связь

Дополнительные ресурсы

Поделиться через

Строки стандартного формата даты и времени

Таблица описателей формата

Как работают строки стандартного формата

Форматы даты

Описатель краткого формата даты ("d").

Описатель полного формата даты ("D").

Форматы даты и времени

Описатель полного формата даты и краткого формата времени ("f").

Описатель полного формата даты и полного формата времени ("F").

Описатель общего формата даты и краткого формата времени ("g").

Описатель общего формата даты и полного формата времени ("G").

Описатель формата обратного преобразования ("O", "o").

Описатель формата RFC1123 ("R", "r").

Описатель сортируемого формата ("s").

Описатель универсального сортируемого формата ("u").

Форматы времени

Описатель краткого формата времени ("t").

Описатель полного формата времени ("T").

Частичные форматы даты

Описатель формата месяца ("M", "m").

Описатель формата месяца года ("Y", "y").

Связанный контент

Обратная связь

Дополнительные ресурсы