toDuration toDuration

Convierte un valor de argumento en una duración. Para obtener más información sobre los tipos de datos, consulte esta página.

Categoría

Conversión

Sintaxis de función

toDuration(<parameter>)

Parámetros

Expresión de cadena If: los formatos aceptados se basan en el formato de duración ISO-8601 PnDTnHnMn.nS con días considerados exactamente 24 horas.

La cadena comienza con un signo opcional, indicado por el símbolo ASCII negativo o positivo. Si es negativo, se anula todo el periodo. La letra ASCII "P" es la siguiente en mayúsculas o minúsculas. A continuación, hay cuatro secciones, cada una de las cuales consta de un número y un sufijo. Las secciones tienen sufijos en ASCII de "D", "H", "M" y "S" para días, horas, minutos y segundos, aceptados en mayúsculas o minúsculas. Los sufijos deben aparecer en orden. La letra ASCII "T" debe aparecer antes de la primera aparición, si la hay, de una sección de hora, minuto o segunda. Al menos una de las cuatro secciones debe estar presente, y si "T" está presente debe haber al menos una sección después de la "T". La parte numérica de cada sección debe constar de uno o más dígitos ASCII. El número puede ir precedido del símbolo ASCII negativo o positivo. El número de días, horas y minutos que se deben analizar. El número de segundos debe analizarse en junto con una fracción opcional. El punto decimal puede ser un punto o una coma. La parte fraccionada puede tener de cero a 9 dígitos.

Firmas y tipo devuelto

toDuration(<string>)

toDuration(<integer>)

Devuelve una duración.

Ejemplos

toDuration("PT10H")

Devuelve una duración de 10 horas.

toDuration("PT4S")

Devuelve la duración de 4 segundos.

toDuration(4000)

Devuelve la duración de 4 segundos.