Compartir vía


Aplicar formato a valores DateTime

Los valores de Azure Storage DateTime deben representarse como valores combinados de hora universal coordinada (UTC). Los formatos UTC se describen mediante ISO 8601.

Formatos ISO 8601 UTC aceptados

Azure Storage acepta actualmente los siguientes formatos ISO 8601 UTC. Se requiere el valor de fecha, mientras que el valor de hora es opcional:

  • YYYY-MM-DD
  • YYYY-MM-DDThh:mm<TZDSuffix>
  • YYYY-MM-DDThh:mm:ss<TZDSuffix>

Para el valor de fecha en estos formatos, YYYY es una representación de año de cuatro dígitos, MM es una representación de mes de dos dígitos a partir de 1 y DD es una representación de día de dos dígitos a partir de 1.

Si se incluye el valor de hora opcional, se requiere un designador T literal para separar el valor de hora del valor de fecha. Para el valor de hora, hh es la representación de hora en notación de 24 horas, mm es la representación de minuto de dos dígitos y ss es la representación de segundo dígitos. Cada uno de estos valores se expresa como un entero, empezando por cero.

Si el valor de tiempo incluye segundos, también puede incluir hasta 7 dígitos decimales de fracciones de segundos, siguiendo el patrón hh:mm:ss[.f{1,7}]. Este patrón es compatible con las API, las herramientas y las bibliotecas cliente de Azure Storage. Debe usar un punto en lugar de comas para delinear el valor de fracciones de segundos.

Si incluye el sufijo <TZDSuffix>opcional de zona horaria , debe expresarse como:

  • Valor literal Z, que designa que el valor de hora se expresa como hora UTC; o
  • Desplazamiento que indica el sesgo de tiempo de la hora UTC. El desplazamiento requiere un desplazamiento inicial + para un desplazamiento positivo y el inicial - para un desplazamiento negativo. El valor del desplazamiento debe estar comprendido entre -23:59 y +23:59.

A continuación se muestra un ejemplo del formato UTC combinado. La fecha se especifica primero, seguida del valor Tliteral , que designa el principio del elemento time. El valor Z literal al final de la cadena indica que la hora se expresa en UTC.

El valor de fecha y hora del 16 de noviembre de 2020 a las 4:25:03 a. m. en hora UTC se expresa como:

2020-11-16T04:25:03Z

Para expresar la misma hora en hora estándar oriental (EST), que es cinco horas antes de esa hora UTC, agregue el desplazamiento al valor:

2020-11-16T04:25:03-05:00

Consulte también

Referencia de API REST de Azure Storage