Fecha como año fraccionario
El conversor de año fraccionario transforma una fecha y hora ISO 8601 explícita en un año decimal como 2024.5.
Ejecutar — gratis
Primero normaliza a UTC el desfase horario indicado; después mide los milisegundos exactos transcurridos desde el inicio de ese año UTC y los divide por su duración completa. La parte entera identifica el año UTC y la parte decimal ubica el instante dentro de él. No consulta el reloj, la ubicación, la red ni valores predeterminados ocultos, por lo que una misma entrada siempre ofrece el mismo resultado.
Qué representa un año decimal fraccionario
Un año fraccionario reúne en un solo número la etiqueta del año natural y una posición continua dentro de él. La parte entera corresponde al año natural UTC que contiene el instante proporcionado. La parte decimal es la duración exacta transcurrida desde el 1 de enero a las 00:00:00.000 UTC, dividida por la duración del año completo. Por ello, el primer instante de 2024 es exactamente 2024 y el punto medio de ese año bisiesto es 2024.5. Cerca del final de 2024, el resultado se aproxima a 2025 sin alcanzarlo; el primer instante de 2025 ya pertenece al nuevo año y vale exactamente 2025. La definición se basa en duración, no en contar hojas del calendario, fechas terminadas, meses, trimestres o días laborables. Horas, minutos, segundos y milisegundos aportan su proporción correspondiente. La respuesta incluye la fecha normalizada en UTC, el año UTC elegido, los milisegundos transcurridos y los milisegundos totales del año. Así, usted puede revisar cada componente o comprobar el cálculo de forma independiente cuando necesite una coordenada anual compacta sin perder la identidad del año natural.
Cómo influyen la normalización UTC y los años bisiestos
La entrada debe identificar un instante real mediante Z o un desfase numérico como +05:30 o -04:00. El conversor aplica ese desfase antes de elegir el año y medir el tiempo transcurrido. El orden es decisivo en los límites anuales: una hora local poco después de la medianoche del 1 de enero todavía puede ser 31 de diciembre en UTC, mientras que una hora local tardía de diciembre puede ser ya 1 de enero en UTC. A continuación se aplican las reglas gregorianas de años bisiestos al año UTC resultante. Los años divisibles por cuatro tienen 366 días, salvo los años de siglo que no son divisibles por cuatrocientos; los demás tienen 365. El denominador cambia así con el año elegido y evita el desfase que produciría suponer una duración fija de 365 días. Cada día civil equivale exactamente a 86,400 segundos y no se incorporan segundos intercalares. El analizador rechaza desfases ausentes o mal formados, fechas imposibles, días bisiestos en años comunes, horas superiores a 23, minutos o segundos superiores a 59 y más de tres cifras de milisegundos. Es preferible rechazar que adivinar una zona horaria, pues una conjetura impediría reproducir el resultado entre sistemas y navegadores.
Uso de años fraccionarios en datos y ciencia
Los años fraccionarios sirven como coordenadas compactas para observaciones repartidas entre numerosos años naturales. Una canalización de series temporales puede convertir marcas con desfase antes de una regresión, interpolación, gráfica o exportación, asignando a cada registro un número ordenable sin eliminar su marca original. Los informes científicos suelen usar años decimales para situar mediciones en un eje anual, y los procesos de migración pueden necesitar reproducir valores de sistemas analíticos antiguos. La respuesta determinista también facilita las pruebas: permite fijar casos de Año Nuevo, día bisiesto, punto medio, cruce de desfase y último milisegundo sin simular el reloj del sistema. Conserve la definición junto a los datos, porque otros programas pueden usar recuentos de días, convenciones basadas en el mediodía, años fijos de 365.25 días o reglas de redondeo distintas. Esta capacidad divide los milisegundos UTC exactos transcurridos por la longitud exacta del año gregoriano proléptico UTC que contiene el instante. Evite redondear durante cálculos intermedios y hágalo solo al presentar una gráfica o informe. No sustituya una marca temporal absoluta por este valor cuando necesite reversibilidad u ordenar instantes extremadamente próximos. Cada cálculo API correcto cuesta $0.002; la misma operación pura también puede ejecutarse en el navegador.
Qué puede hacer con ella
Normalizar observaciones temporales
Convierta marcas explícitas con desfase en coordenadas decimales continuas para gráficas, regresión e interpolación.
Reproducir ejes de informes científicos
Genere años fraccionarios auditables con una convención documentada de duración gregoriana UTC.
Crear casos de prueba deterministas
Compruebe años bisiestos y cruces de zona horaria sin consultar ni simular la hora actual del sistema.
Preguntas frecuentes
¿Qué fórmula se utiliza?
El resultado es el año UTC más los milisegundos transcurridos desde su inicio, divididos por los milisegundos totales de ese año UTC.
¿Por qué debe incluir zona horaria?
Sin Z ni un desfase numérico, el texto no identifica un único instante y podría producir respuestas distintas según el entorno.
¿Cómo se tratan los años bisiestos?
El año UTC correspondiente usa 366 días según las reglas gregorianas y, en los demás casos, 365 días.
¿Se incluyen segundos intercalares?
No. Cada día civil se considera de exactamente 86,400 segundos para obtener un resultado determinista y portable.
¿Cuánto cuesta un cálculo mediante API?
Cada solicitud API correcta cuesta $0.002. La operación pura también puede ejecutarse localmente en el navegador.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/date/fractional-year \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"datetime":"2024-07-02T00:00:00Z"}'const res = await fetch("https://api.kit.forhosting.com/date/fractional-year", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"datetime": "2024-07-02T00:00:00Z"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/fractional-year",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"datetime": "2024-07-02T00:00:00Z"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/fractional-year", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"datetime":"2024-07-02T00:00:00Z"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"datetime":"2024-07-02T00:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/fractional-year", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"datetime": "2024-07-02T00:00:00Z"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.fractional_year",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |