Todos os produtos
Search
Central de documentação

Resource Orchestration Service:Fn::FormatTime

Última atualização: Jun 27, 2026

A função Fn::FormatTime retorna a hora atual no formato especificado.

Declaração

  • JSON

    • Obtenha a hora atual em um fuso horário específico:

      {
        "Fn::FormatTime": [
          format,
          <time_zone>
        ]
      }
    • Obtenha a hora atual no fuso horário UTC padrão:

      {
       "Fn::FormatTime": format
      }
  • YAML

    • Obtenha a hora atual em um fuso horário específico:

      Fn::FormatTime:
        - format
        - <time_zone>
      !FormatTime [format, <time_zone>]
    • Obtenha a hora atual no fuso horário UTC padrão:

      Fn::FormatTime: format
      !FormatTime format

Parâmetros

  • format: Obrigatório. String de formato de data, como "%Y-%m-%d %H:%M:%S".

    A tabela a seguir descreve os campos de formato compatíveis.

    Campo

    Descrição

    Exemplo

    %y

    Ano sem o século, como número decimal preenchido com zeros à esquerda. Por exemplo, 2001 é representado como 01.

    21

    %Y

    Ano com o século, como número decimal.

    2021

    %m

    Mês como número decimal preenchido com zeros à esquerda.

    04

    %d

    Dia do mês como número decimal preenchido com zeros à esquerda.

    07

    %H

    Hora (formato de 24 horas) como número decimal preenchido com zeros à esquerda.

    14

    %I

    Hora (formato de 12 horas) como número decimal preenchido com zeros à esquerda.

    08

    %M

    Minuto como número decimal preenchido com zeros à esquerda.

    09

    %S

    Segundo como número decimal preenchido com zeros à esquerda.

    10

    %a

    Nome abreviado do dia da semana.

    Wed

    %A

    Nome completo do dia da semana.

    Wednesday

    %b

    Nome abreviado do mês.

    Apr

    %B

    Nome completo do mês.

    April

    %c

    Data e hora.

    Wed Apr 7 08:15:10 2021

    %j

    Dia do ano como número decimal preenchido com zeros à esquerda.

    097

    %p

    Valores válidos:

    • AM: manhã

    • PM: tarde/noite

    AM

    %U

    Número da semana no ano (domingo como primeiro dia da semana), como número decimal preenchido com zeros à esquerda.

    Nota

    Todos os dias anteriores ao primeiro domingo de um novo ano pertencem à Semana 0.

    14

    %w

    Dia da semana como número decimal.

    0 representa domingo e 6 representa sábado.

    3

    %W

    Número da semana no ano (segunda-feira como primeiro dia da semana), como número decimal.

    Nota

    Todos os dias anteriores à primeira segunda-feira de um novo ano pertencem à Semana 0.

    14

    %x

    Data.

    04/07/21

    %X

    Hora.

    08:15:10

    %Z

    Nome do fuso horário. Valores válidos:

    • UTC

    • GMT

    UTC

    %f

    Microssegundo como número decimal preenchido com zeros à esquerda.

    091798

    %z

    Deslocamento UTC, no formato +HHMM ou -HHMM.

    +0000

    %%

    Sinal de porcentagem (%).

    %

  • time_zone: Opcional. Fuso horário, como UTC(default), Asia/Shanghai.

Valor de retorno

A hora atual no formato especificado.

Exemplos

  • Fn::FormatTime: %Y-%m-%d %H:%M:%S

    Exemplo de resultado:

    2021-06-11 03:48:19
  • Fn::FormatTime: %Y-%m-%d %H:%M:%S,Asia/Shanghai

    Exemplo de resultado:

    2021-06-11 12:01:25