datetime-add
El resultado es el valor datetime que se obtiene al añadir un valor duration (segundo argumento) a un valor datetime (primer argumento).
Lenguajes
Disponible para Java, C#, C++ y el motor de ejecución integrado.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
datetime | xs:dateTime | Indica el valor xs:dateTime que se debe usar como entrada. |
duration | xs:duration | Indica el valor de xs: duration.
Un ejemplo del parámetro duration es P1Y2M3DT04H05M59S, donde:
•"P" designa el periodo y es obligatorio; •El resto de caracteres representa, en este orden: 1 año, 2 meses, 3 días, T (indica el tiempo), 04 horas, 05 minutos, 59 segundos.
Si aparece el caracter menos (-) antes de "P" la duración se entiende como negativa, por ejemplo: -P1D. |
Ejemplo
Imagine que el valor de entrada datetime es 2001-12-17T09:30:02+05:00. Si duration es P10D (10 días), entonces el resultado de la función es 2001-12-27T00:00:00+05:00.
Para extraer la fecha de ayer de la entrada dateTime, use la función now para introducir la fecha/hora actual incluido el uso horario. El período se puede convertir en negativo usando el carácter - antes del designador P (por ejemplo -P1D, menos 1 día).