Saltar al contenido principal

duration

El tipo de dato duration se utiliza para representar una duración de tiempo.

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="duracion" type="xs:duration"/>
</xs:schema>

Algunos valores válidos para un duration son:

<duracion>P2Y4M3DT5H6M7S</duracion>
<duracion>P2Y</duracion>
<duracion>P0Y20M0D</duracion>
<duracion>-P4Y</duracion>
<duracion>-P60D</duracion>
<duracion>PT1M30.5S</duracion>

Algunos valores no válidos son:

<duracion>P20MT</duracion>
<duracion>P15.5Y</duracion>
<duracion>1Y2M</duracion>
<duracion>P</duracion>

Formato de una duración​

El formato utilizado es el siguiente:

PnYnMnDTnHnMnS

Cada n se corresponde, respectivamente, con años, meses, días, horas, minutos y segundos.

Por ejemplo, para representar una duración de 2 años, 4 meses, 3 días, 5 horas, 6 minutos y 10 segundos se utilizaría la siguiente cadena:

P2Y4M3DT5H6M7S

Se pueden omitir los valores nulos.

Por ejemplo, una duración de 2 años puede representarse de la siguiente forma:

P2Y

Se pueden utilizar decimales.

Por ejemplo, una duración de 1 minuto y 30.5 segundos se representa con la siguiente cadena de texto:

PT1M30.5S

Se pueden indicar duraciones negativas utilizando el prefijo -P en lugar de P.

Por ejemplo, una duración de -2 años se representa de la siguiente forma:

-P2Y

Aplicaciones​

Algunos ejemplos de uso de duration son:

  • Describir la duración de un evento o actividad, como una conferencia o un concierto.
  • Describir el tiempo de vida útil de un producto o servicio, como una garantía o una suscripción.
  • Describir la duración de una tarea o proyecto en una aplicación de seguimiento de tiempo.
  • Describir el tiempo de entrega de un pedido o el tiempo de envío de un paquete.
  • Describir la duración de una pausa o descanso en un horario de trabajo o una programación de actividades.