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

Si la expresión de cadena: Los formatos aceptados se basan en el formato de duración ISO-8601 PnDTnHnMn.nS con días considerados exactamente como 24 horas.

La cadena comienza con un signo opcional, que se indica con 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. Luego hay cuatro secciones, cada una compuesta por 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 incidencia, si la hay, de una hora, minuto o segunda sección. Al menos una de las cuatro secciones debe estar presente, y si la "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 debe analizarse a lo largo. El número de segundos debe analizarse con junto con la 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 la duración de 10 horas.

toDuration("PT4S")

Devuelve la duración de 4 s.

toDuration(4000)

Devuelve la duración de 4 s.