Formatos de data/hora personalizados

Os formatos de data e hora personalizados permitem definir padrões específicos para converter valores de data e hora em representações de "string". Use convenções pré-definidas para especificar um formato de data/hora personalizado. Os formatos permitem visualizar as datas e horários de uma maneira que atenda às necessidades específicas.

Use convenções pré-definidas para especificar um formato de data/hora personalizado. Veja a seguir alguns exemplos de formatos de data e hora personalizados:
Nota: Todas as convenções predefinidas que são usadas para especificar um formato de data/hora personalizado diferenciam maiúsculas e minúsculas.

Formato "y" e "Y"

Especifique um ano como "yy" ou "yyyyy" e especifique o ano da semana como "YY" respectivamente.
Nota: O "yy" e o "YY" fornecem o mesmo resultado, contudo o resultado irá diferir se você usar um formato de data/hora que inclui a última semana ou a primeira semana de um ano civil.

Por exemplo, quando você usa um formato de data/hora como 12/26/22 (2022/12/26), depois executar ações para excluir os arquivos do ano anterior, o formato de data/hora "yy" fornece o resultado correto (12/26/21) e os arquivos do ano 2021 são excluídos. Se você usar o formato de data/hora "YY" (indicando o ano da semana em que o dia específico aparece), os arquivos do ano 2022 serão apagados porque o dia 12/26/21 cai durante a última semana de 2021 e também durante a primeira semana de 2022.

Exemplo de calendário

Recomendamos que utilize o formato de data/hora "yy" quando quiser considerar apenas o ano civil e não uma semana específica desse ano civil.

Formato "M"

especifique um mês no formato "M", "MM", "MMM" (nome abreviado do mês, por exemplo, jan, fev) ou "MMMM" (nome completo do mês, por exemplo, janeiro, fevereiro).
Nota: Os formatos de data/hora "MMM" e "MMMM" funcionam dependendo do sistema operacional no qual o Agente de bot é executado e da sua configuração de localização.

Formato "d"

especifique um dia no formato “d” ou “dd”.

Formato "D"

especifique um dia do ano no formato “D” ou “DD”.

Formato "E"

especifique o dia da semana no formato “EEE” (dom-sáb) ou “EEEE” (domingo-sábado).
Nota: Os formatos de data/hora "EEE" e "EEEE" funcionam dependendo do sistema operacional no qual o Agente de bot é executado e da configuração de localização.

Formato "F" ou "FF"

Especifique o dia da semana em um mês com ou sem zero à esquerda. Por exemplo, aaaa-ss-F ou aaaa-ss-0F.
Nota: Para especificar o dia da semana em um mês, você também pode especificar o formato fixo como ISO_WEEK_DATE (\'2012-W48-6\')

Formato "h"ou "H"

especifique uma hora no formato “hh” ou “HH”.
Nota: HH é o formato de tempo de 24 horas e hh é o formato de tempo de 12 horas usando AM ou PM. Quando usar o formato hh, adicione a no final do formato de data/hora. Por exemplo, se o idioma local do sistema for inglês, a entrada será 2018-12-25 10:50:55.999 AM e o formato será aaaa-MM-dd hh:mm:ss.SSS, em que a indica AM ou PM. Entretanto, em computadores que usam sistemas operacionais em outros idiomas que não o inglês, use o marcador AM ou PM de forma adequada. Por exemplo, em um sistema operacional em japonês, a entrada deve ter um marcador AM ou PM em japonês, como 2018-12-25 10:50:55.999 午前, em que 午前 significa AM em japonês, e o formato deve ser aaaa-MM-dd hh:mm:ss.SSS a.

Formato "a"

Especifique um marcador AM/PM para o formato de 12 horas.

Formato "m"

especifique o minuto da hora no formato “mm”.

Formato "s"

especifique o segundo do minuto no formato “ss”.

Formato "S"

especifique um milissegundo no formato “SSS”.

Formato "z"

especifique um fuso horário, como “Horário padrão do pacífico” e “Horário padrão da Índia”.

Formato "Z"

especifique um horário de compensação para um fuso horário, como \'+0550\' para o “Horário padrão da Índia”.

Importante: Em computadores em que o idioma da tela é definido como chinês simplificado ou chinês tradicional, quando você usa o formato de data/hora personalizado dd-MMM-aaaa para converter um valor de data/hora em um valor de string, a saída pode aparecer incorretamente.

Exemplos

Use a convenção anterior para especificar o formato personalizado que você deseja usar para converter um valor de data/hora. Aqui estão alguns exemplos que utilizam a convenção anterior:
Nota: O formato h.mm a não é atualmente compatível.
Formato Saída de exemplo
aaaa-MM-dd 2018-09-08
aaaaa-M-d 2018-9-8
dd-MM-aaaa 08-09-2018
aaaa-MM-dd HH:mm:ss 2018-09-08 23:50:55
hh:mm:ss.SSS a 10:15:35.889 AM / 10:15:35.889 PM
aaaa-MM-dd HH:mm:ss.SSS 2018-09-08 23:50:55.999
aaaa-MM-dd HH:mm:ss.SSS Z 2018-09-08 23:50:55.999 +0530
D:dd-MM-aaaa 130:08-09-2018
D “dias”, yyyy 365 dias, 2019