Fracción del año transcurrida

Convierte a UTC la hora indicada con Z o con un desplazamiento numérico, mide los milisegundos exactos desde el 1 de enero a las 00:00:00 UTC y divide esa duración entre la longitud completa del año UTC resultante. Los años bisiestos tienen 366 días y los comunes, 365. La fecha actual, la zona horaria local, la red, el azar y los valores predeterminados ocultos no pueden modificar el resultado.

Qué significa la fracción del año transcurrida

La fracción devuelta es una medida continua del avance dentro de un año natural UTC. El numerador es la cantidad de milisegundos desde el 1 de enero a las 00:00:00.000 UTC hasta el instante indicado, y el denominador es la cantidad de milisegundos de todo ese año UTC. En el primer instante del 1 de enero, el resultado es exactamente cero. Después aumenta durante el año, pero permanece por debajo de uno para cualquier fecha y hora válida de ese año; uno corresponde al primer instante del año siguiente, donde el cálculo vuelve a comenzar en cero. Esto no equivale a un porcentaje basado en el día del año que cuente fechas completas o dé por terminado el día actual. El mediodía aporta la mitad de esa fecha, los segundos aportan su parte exacta y se conservan hasta tres cifras decimales de segundo como milisegundos. El denominador comprende 365 días en un año común y 366 en uno bisiesto gregoriano. Como el desplazamiento se normaliza antes de elegir el año UTC, un instante escrito al final del 31 de diciembre en otra zona puede pertenecer correctamente al 1 de enero del siguiente año UTC.

Cómo proporcionar una fecha y hora ISO inequívoca

Envíe datetime con el formato YYYY-MM-DDTHH:mm:ssZ; puede añadir de una a tres cifras decimales de segundo o sustituir Z por un desplazamiento con signo, como +05:30 o -04:00. El indicador de zona horaria es obligatorio porque una fecha y hora sin él no identifica un instante único. Se rechazan, sin intentar adivinarlas, las fechas sin hora, los formatos locales, los nombres de meses, los espacios en lugar de T y los desplazamientos sin dos puntos. El analizador también valida la longitud gregoriana de los meses, los días bisiestos, las horas, los minutos, los segundos y el desplazamiento. No se admiten segundos intercalares: los segundos van de 00 a 59, de acuerdo con el modelo determinista de minutos civiles. Tras analizar la entrada, se aplica el desplazamiento mediante aritmética entera y el instante resultante se expresa como utc_datetime. La respuesta incluye además utc_year, elapsed_milliseconds y year_milliseconds, para que pueda auditar la fracción sin reconstruir las reglas del calendario. Dos cadenas que describan el mismo instante con desplazamientos distintos producen la misma fecha normalizada y la misma fracción. Una solicitud automatizada correcta cuesta $0.002; el cálculo también puede ejecutarse localmente en el navegador.

Aplicaciones de una proporción anual determinista

Use esta capacidad cuando un modelo, una visualización, un informe o una prueba necesite una posición estable dentro del año natural, en vez de una respuesta ligada al momento en que se ejecute una máquina. Los paneles pueden convertir la fracción en porcentaje o barra de progreso y conservar el numerador y el denominador exactos para etiquetas y auditorías. Los procesos de datos pueden enriquecer registros con marca temporal mediante una coordenada anual normalizada para análisis estacionales, interpolaciones o variables cíclicas, con la certeza de que las entradas con desplazamiento se comparan sobre la misma cronología UTC. Las pruebas pueden fijar casos límite en Año Nuevo, el día bisiesto o el último milisegundo de diciembre sin simular un reloj. El resultado se basa en duración transcurrida, por lo que no sirve para contar fechas completadas, días laborables, periodos fiscales ni meses de igual longitud. También modela deliberadamente los días civiles UTC como 86.400 segundos y no introduce segundos intercalares, lo que hace portátil y reproducible la operación. Si necesita un porcentaje, multiplique fraction por cien y redondee solo al mostrarlo. Para una proporción fiscal, use los límites del calendario fiscal correspondiente.