DateTime como Dados STRING

Se o objeto dateTime for Decimal Compactado CWF, você poderá utilizar apenas símbolos que são apresentados como números. Para todas as demais opções de Tipo Físico, você pode utilizar todos os símbolos.

Você pode especificar o formato dateTime utilizando uma cadeia de letras padrão. A contagem de letras padrão determina o formato. A tabela de símbolos de formatação dateTime abaixo define as letras que estão reservadas como letras padrão:

Símbolo Significado Apresentação Exemplo
a marcador am ou pm Texto pm
d dia no mês Número 10
D dia no ano Número 189
e dia na semana (1-7) Número 2
E dia na semana Texto Terça-feira
F dia da semana no mês Número 2 (2ª quarta-Feira de julho)3
G Era Texto AD
h hora em am ou pm (1-12) Número 12
I hora do dia (0-24) Número 0
I Analisar como Data/Hora (ISO8601)   (nota 6)
k hora no dia (1-24) Número 24
K hora em am ou pm (0-11) Número 0
m minuto na hora Número 30
M mês no ano Texto e Número Julho e 07
w semana no ano Número 272
W semana no mês Número 2
s segundo no minuto Número 55
S milissegundo Número 978
T Analisar como Hora (ISO8601)   (nota 6)
y ano Número 19961
S ano: utilizar apenas com semana no ano Número 19962
z TimeZone Texto zzzz = Hora Padrão do Pacífico
Z fuso horário Texto +05:30
' escape para texto   'Texto do usuário'
'' aspas simples em texto de escape   'o''clock'

A apresentação do objeto dateTime depende de quais símbolos são especificados da seguinte forma:

Notes:

Os pontos a seguir explicam as notas na tabela acima:

  1. O ano é tratado de forma especial:
    • Na saída, se a contagem de y for 2, o ano será truncado para 2 dígitos. Por exemplo, se yyyy produz 1997, aa produz 97.
    • Na saída, para anos com 2 dígitos, a propriedade do conjunto de mensagens CWF de Janela Século é utilizada para determinar o século. Por exemplo, se Janela Século for definida como 53, ano 97 é 1997, ano 52 será 2052 e ano 53 será 1953.
  2. O primeiro dia do ano geralmente não cai em um limite da semana, portanto, as datas expressas em ano podem referir-se a datas em anos próximos. Por exemplo, o dia 1 da semana 1 em 2002 (Segunda-feira 01 2002) utilizando a cadeia de formatações YYYY ww EEEE é de fato 31 de dezembro de 2001. Se você utilizar Y, o dia da semana (E) e a semana no ano (w) serão ajustados, se necessário, para indicar que a data cai no ano anterior. Se você utilizar o símbolo y, o ajuste não será feito e podem ocorrer resultados imprevisíveis para datas próximas do final do ano.

    Por exemplo, se a cadeia Segunda-feira 01 2002 estiver formatada:

    • o dia 1 da semana 1 em 2002 utilizando a cadeia de formatações YYYY ww EEEE será corretamente interpretado como 31 de dezembro de 2001
    • o dia 1 da semana 1 em 2002 utilizando a cadeia de formatações yyyy ww EEEE será incorretamente interpretado como 30 de dezembro de 2002

    Y deve ser utilizado apenas junto com w. Se você especificar Y sem w, o ano será ignorado. Por exemplo, se você especificar YYYY-mm-dd para o formato 1996-03-01, o resultado será 2002-03-01, pois a entrada de ano é ignorada e o ano atual é assumido.

  3. O dia 11 de julho de 2001 é a segunda quarta-feira de julho é pode ser expresso como Quarta-feira, 2 de julho de 2001 utilizando a cadeia de formatações yyyy MMMM EEEE F. Este formato não é igual à quarta-feira na semana 2 de julho de 2001, que é 4 de julho de 2001.
  4. A primeira e a última semanas em um mês podem incluir dias de meses próximos. Por exemplo, terça-feira, 31 de julho de 2001 pode ser expresso como Terça-feira na semana um de agosto de 2001, que é Terça-feira, 1 08 2001 utilizando a cadeia de formatações yyyy MM W EEEE.
  5. Você pode expressar um fuso horário apenas como um deslocamento em horas e minutos a partir de GMT (+/-hh:mm). O número de símbolos de formatação Z afeta a saída:
    • -Z (formato breve) produz -5
    • -ZZ (formato médio) produz -05
    • -ZZZ (formato longo) produz -05:00
    • -ZZZZ (formato longo) produz GMT-05:00
  6. Você pode utilizar o símbolo de formatação I (letra "i" maiúscula) para corresponder a qualquer cadeia dateTime ISO8601. Exemplos disso são mostrados nos exemplos dateTime ISO8601 abaixo. Um I deve ser utilizado apenas sozinho.

    Na entrada para um fluxo de mensagens, uma cadeia de formatação de I permite a análise de qualquer dateTime compatível com ISO8601. Na saída de um fluxo de mensagens, dateTime é sempre expresso no formato mais completo yyyy-MM-dd'T'HH:mm:ss.SSS.

    Se você utilizar o símbolo de formatação T, as cadeias de formatações poderão ser construídas para corresponder a dateTimes ISO8601, em que T precede o período de tempo de uma entidade dateTime.

Exemplos

A tabela a seguir mostra exemplos de formatos dateTime:

Padrão de formato Resultado
"yyyy.MM.dd'at'HH:mm:ss ZZZ" 1996.07.10 às 15:08:56 -05:00
EEE, MMM d, "yy" Qua, 10 julho, '96
"h:mm a" 8:08 h
"hh 'o''clock' a, ZZZZ" 09:00 h, GMT+09:00
"K:mm a, ZZZ" 9:34 AM, -05:00
"yyyy.MMMMM.dd hh:mm aaa" 1996.julho.10 12:08 h

Os seguintes são exemplos de dateTime ISO8601:

Ano
      yyyy
Ano e mês
   yyyy-MMData completa
   yyyy-MM-ddData completa mais horas e minutos
   yyyy-MM-ddTHH:mm
Data completa mais horas, minutos e segundos
   yyyy-MM-ddTHH:mm:ss
Data completa mais horas, minutos, segundos e uma fração decimal de
um segundo
   yyyy-MM-ddTHH:mm:ss.S

Você pode criar cadeias de formatações que produzem resultados imprevisíveis, portanto, é necessário utilizar esses símbolos com atenção. Por exemplo, se você especificar dMyyyy , será impossível distinguir entre dia, mês e ano. dMyyyy informa o intermediário que um mínimo de um caractere representa o dia, um mínimo de um caractere representa o mês e quatro caracteres representam o ano. Portanto, 3111999 pode ser interpretado como 3/11/1999 e 31/1/1999.

Conceitos relacionados
Modelagem de Mensagens
O Modelo de Mensagem

Tarefas relacionadas
Desenvolvendo Modelos de Mensagens
Trabalhando com um Arquivo de Definição de Mensagem
Trabalhando com Objetos de Modelo de Mensagem

Referências relacionadas
Informações de Referência do Modelo de Mensagens
Propriedades do Objeto de Modelo de Mensagem