Guia de Integração

Formatação de datas

O PagSeguro utiliza o formato de datas datetime definido pela W3C em sua forma mais completa, incluindo data, hora, minutos, segundos, frações de segundos e time-zone.

A representação desses valores é feita seguindo o padrão: YYYY-MM-DDThh:mm:ss.sTZD

Onde:

Dígito DESCRIÇÃO
YYYY quatro dígitos para o ano
MM dois dígitos para o mês (01=Janeiro, etc.)
DD dois dígitos para o dia do mês (de 01 até 31)
hh dois dígitos para horas (de 00 até 23) (am/pm não é permitido)
mm dois dígitos para minutos (de 00 até 59)
ss dois dígitos para segundos (de 00 até 59)
s três dígitos para a fração de segundos
TZD informa o fuso horário +hh:mm ou -hh:mm

A especificação não determina uma quantidade fixa de dígitos para a fração de segundos e também deixa opcional a exibição do time-zone entre ±hh:mm ou simplesmente o caractere Z. Nos serviços do PagSeguro, sempre utilizamos três dígitos para a fração de segundos e sempre informamos o time-zone na forma ±hh:mm.

Segue um exemplo real de como um campo de data é informado pelas APIs do PagSeguro. Repare que o caractere 'T' aparece explicitamente indicando o início de um elemento de tempo.

Dúvidas de como integrar com o PagSeguro? Participe das discussões e tire suas dúvidas no Comunidade PagSeguro.