Documentación/Funciones de Calc/HORANUMERO

    From The Document Foundation Wiki
    This page is a translated version of the page Documentation/Calc Functions/TIMEVALUE and the translation is 93% complete.
    Other languages:


    Nombre de la función:

    HORANUMERO

    Categoría:

    Fecha y hora

    Resumen:

    Toma una expresión de fecha válida pasada como una cadena y convierte su componente de tiempo en un número de serie de fecha y hora.

    Sintaxis:

    HORANUMERO(DateTime)

    Devuelve:

    Devuelve un número real (0 ≤ x < 1) que es la parte fraccionaria del número de serie de fecha y hora calculado con el argumento proporcionado. El valor devuelto tiene el formato de un número de forma predeterminada, pero puede aplicar otros formatos según sea necesario.

    Argumentos:

    FechaHora es la cadena (entre comillas) o una referencia a una celda que contiene esa cadena, que es la expresión de fecha que se utilizará. Si tiene la intención de colocar la cadena en una celda, asegúrese de que la celda tenga el formato de texto.

    • Si FechaHora no contiene una expresión de fecha válida, HORANUMERO mostrará un error de argumento no válido (Err:502).
    • Si FechaHora no tiene un componente de hora, HORANUMERO mostrará un error de argumento no válido (Err:502).
    • HORANUMERO ignorará cualquier componente de fecha de FechaHora.
    • Si FechaHora hace referencia a una celda que contiene una expresión de fecha válida con formato de fecha, HORANUMERO devolverá un error de argumento no válido (Err:502). Esto se debe a que Calc maneja el valor en esa celda como un número en lugar de una cadena de texto.

    Detalles adicionales:

    Información general sobre las funciones de fecha y hora de Calc

    Note pin.svg

    Nota:
    Para mayor comodidad, la información de esta subsección se repite en todas las páginas que describen funciones en la categoría Fecha y hora.

    • Internamente, Calc trata a valores de fecha-hora como números reales, y esto a veces se denomina con el término de número de serie de fecha-hora. Por ejemplo, 2021-02-08 12:00:00 corresponde al número de serie de fecha-hora 44235.5. La parte entera de un número de serie de fecha-hora (antes del punto decimal) es el número de días desde una fecha de inicio definida. La parte fraccionaria de un número de serie de fecha-hora (después del punto decimal) es la hora del día expresada como una fracción de día. Por ejemplo, 0.25 equivale a 06:00:00 y 0.75 es equivalente a 18:00:00.
    • Calc considera la fecha 1899-12-30 como la inicial (día 0) de manera predeterminada, pero puede ir a Herramientas ▸ Opciones ▸ LibreOffice Calc ▸ Calcular para seleccionar fechas de inicio alternativas; no obstante, a no ser que tenga requisitos específicos de compatibilidad con aplicaciones de hoja de cálculo antiguas, es recomendable que no modifique esta configuración. Si copiare y pegare celdas que contengan valores de fecha entre distintas hojas de cálculo, habrá de cerciorarse de que ambos documentos tengan definida la misma fecha de inicio, para evitar cambios sorpresivos en las fechas mostradas.
    • Los números de serie de fecha-hora negativos corresponden a fechas anteriores a la fecha de inicio definida en Calc. Calc calcula todas las fechas desde el 15 de octubre de 1582 utilizando el calendario gregoriano. El día anterior es el 4 de octubre de 1582, y para fechas anteriores, Calc usa el calendario juliano.
    • Un número de serie de fecha-hora no es más que un número común y corriente, con la diferencia de que se suele preferir darle el formato de fecha/hora. Puede introducir un número en una celda y luego cambiar el formato de la celda para que se muestre el valor como una fecha/hora. También puede introducir una fecha/hora en una celda y luego cambiar el formato de esta para que se visualice el valor como un número de serie.
    • Para mayor claridad, las descripciones de las funciones de Calc dentro de estas páginas wiki usan el formato estándar ISO 8601 para fecha y hora porque esto debería ser independiente de la configuración regional seleccionada. El formato de fecha predeterminado en su ordenador puede ser diferente. Al ingresar fechas como parte de fórmulas, las barras o guiones utilizados como separadores de fecha pueden interpretarse como operadores aritméticos. Por lo tanto, las fechas ingresadas en este formato no se reconocen como fechas y dan como resultado cálculos erróneos. Para evitar que las fechas se interpreten como partes de fórmulas, utilice la función FECHA o coloque la fecha entre comillas y utilice la notación ISO 8601. Evite el uso de formatos de fecha dependientes de la configuración regional que pueden producir errores si el documento se carga con una configuración regional diferente.
    • Las funciones de fecha y hora de Calc no utilizan los datos de huso horario.
    • Si desea introducir sólo dos dígitos para el año (por ejemplo, «21» en vez de «2021»), Calc ha de saber si usted entiende «21» como 2021 o como 1921. Diríjase a Herramientas ▸ Opciones ▸ LibreOffice ▸ General para ver o ajustar el intervalo de años que Calc deberá utilizar para interpretar los valores de año de dos dígitos.
    • Calc utiliza cierta lógica para decidir cómo tratar el texto cuando este se encuentra como un operando en una operación aritmética o como un argumento para una función que espera un número en su lugar. En este contexto, la conversión inequívoca es posible para fechas y horas ISO 8601 en sus formatos extendidos con separadores. Por ejemplo, la fórmula simple =1 + "2021-02-08" generalmente dará el resultado 2021-02-09 (cuando se formatea como una fecha). Sin embargo, esta lógica puede verse afectada por la configuración en el cuadro de diálogo Configuración de cálculo detallado, se accede seleccionando Herramientas ▸ Opciones ▸ LibreOffice Calc ▸ Fórmula y presionando el botón Detalles en el área Configuración detallada de cálculo. Si se da un error de #¡VALOR!, puede deberse a que la opción Generar error #¡VALOR! está seleccionada en el menú desplegable Conversión de texto a número, en cuyo caso debe experimentar con alguna de las otras opciones que se explican por sí mismas.

    Ejemplos:

    Fórmula Descripción Devuelve
    =HORANUMERO("09:00:00") La función devuelve el valor 0,375, que es el número de serie de fecha y hora para la hora 09:00:00. 0,375
    =HORANUMERO("2021-02-24T18:00:00") La función devuelve el valor 0,75, que es el número de serie de fecha y hora para la hora 18:00:00. Tenga en cuenta que HORANUMERO ignora los componentes de fecha del argumento FechaHora. 0,75
    =HORANUMERO(D9) donde la celda D9 contiene el valor 12:00:00 con formato de texto. La función devuelve el valor 0,5; que es el número de serie de fecha y hora para la hora 12:00:00. 0,5
    =HORANUMERO("2021-02-24") La función devuelve un error de argumento no válido (Err:502) porque el argumento FechaHora no contiene ningún componente de tiempo. Err:502

    Funciones de LibreOffice relacionadas:

    FECHA

    FECHANUMERO

    NSHORA

    VALOR

    Norma ODF:

    Sección 6.10.18, parte 2

    Funciones equivalentes de Excel:

    TIMEVALUE