ForHosting KIT · Utilidades de desarrollo

Día de la semana de Año Nuevo

Esta calculadora del día de la semana de Año Nuevo recibe una fecha ISO explícita, toma su año de cuatro cifras e indica en qué día cae el 1 de enero de ese año.

● BetaGratis · en su navegador

Ejecutar — gratis Cómo funciona y API

Úselo desde WebAPIEmailTelegramApp pronto

El resultado se obtiene únicamente de la fecha proporcionada y de las reglas del calendario gregoriano, sin depender de la fecha actual, del reloj del servidor, de la zona horaria del navegador ni de un servicio de calendarios externo. La respuesta incluye el nombre del día, su número ISO y la fecha exacta utilizada.

Use cualquier fecha para identificar el año pertinente

Introduzca una fecha de calendario explícita en formato ISO YYYY-MM-DD. La calculadora valida la fecha completa, incluido el número de días del mes y la regla especial de febrero en los años bisiestos, y después toma el año para realizar el cálculo. Por ejemplo, una fecha de agosto de 2026 no solicita el día de la semana de esa fecha de agosto: el resultado corresponde expresamente al 1 de enero de 2026. Esto resulta práctico cuando un registro, un plazo, una factura o un evento ya contiene una fecha y se necesita conocer el comienzo de ese mismo año. Exigir una fecha completa y válida evita entradas ambiguas como 03/04/26, cuyo mes y día dependen de la convención regional. Se admiten años desde 0001 hasta 9999 y se aplica de forma uniforme el calendario gregoriano proléptico. La salida repite la entrada aceptada, identifica el año extraído y muestra la fecha normalizada de Año Nuevo, de modo que la base de la respuesta siempre queda explícita.

Comprenda el cálculo determinista del día de la semana

El cálculo cuenta los días de todos los años completos anteriores al año indicado. Un año común aporta 365 días; un año bisiesto aporta uno más según la regla gregoriana: los años divisibles entre cuatro son bisiestos, salvo los divisibles entre cien, aunque los divisibles entre cuatrocientos sí lo son. El total se reduce módulo siete, con el lunes como día ISO 1 y el domingo como día ISO 7. Esa aritmética determina directamente el día en que comienza el 1 de enero. No intervienen el reloj del sistema, la configuración regional, una base de zonas horarias, valores aleatorios, solicitudes de red ni el objeto Date de JavaScript. Por ello, una misma entrada válida produce la misma respuesta JSON en un proceso de API, en un navegador de otro país o en una prueba configurada con otra zona horaria. La respuesta ofrece tanto un nombre legible como el número ISO, útil para mostrar el dato y para ordenar, bifurcar o integrarlo en otros sistemas.

Aplique el resultado a la planificación y la automatización

Conocer el día de la semana del 1 de enero permite entender cómo se alinea un año con los horarios semanales recurrentes. El dato sirve para generar agendas anuales, configurar periodos de informes, revisar archivos, preparar plantillas de turnos o resolver consultas de calendario. En un flujo automatizado, envíe la fecha vinculada al registro y utilice el número ISO devuelto para elegir un diseño o una rama del proceso. Un resultado 6 o 7 sitúa Año Nuevo en fin de semana según el patrón habitual de lunes a viernes; los valores del 1 al 5 lo sitúan entre semana. La capacidad informa de hechos calendáricos, pero no supone qué días considera laborables o festivos una organización. Para fechas históricas, aplica retrospectivamente las reglas gregorianas por coherencia, incluso donde se utilizó otro calendario civil. La ejecución en el navegador es gratuita y una solicitud por API cuesta $0.002. Como el resultado depende solo de la entrada, también sirve para compilaciones reproducibles, informes en caché, pruebas de regresión y transformaciones auditables.

Qué puede hacer con ella

Crear una agenda anual

Seleccione la columna correcta para el 1 de enero antes de generar las semanas restantes del calendario anual.

Clasificar el inicio del año

Utilice el número de día ISO para saber si Año Nuevo comienza en un día laborable convencional o en fin de semana.

Comprobar calendarios archivados

Compare el día calculado para el 1 de enero con un informe histórico o un calendario importado bajo reglas gregorianas uniformes.

Preguntas frecuentes

¿Qué formato de fecha se debe enviar?

Envíe una fecha ISO completa en formato YYYY-MM-DD, por ejemplo, 2026-08-07.

¿Influyen el mes o el día en la respuesta?

Deben formar una fecha válida, pero el cálculo toma el año de esa fecha para evaluar el 1 de enero correspondiente.

¿La zona horaria afecta al resultado?

No. El cálculo usa aritmética entera del calendario gregoriano y nunca convierte la entrada en una marca de tiempo local.

¿Cómo se tratan los años bisiestos?

Son bisiestos los años divisibles entre cuatro, salvo los años de siglo, excepto cuando también son divisibles entre cuatrocientos.

¿Cuánto cuesta?

Puede ejecutarse gratis en el navegador. Cada solicitud por API cuesta $0.002.

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

POSThttps://api.kit.forhosting.com/date/weekday-of-new-year

¿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/weekday-of-new-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-08-07"}'

const res = await fetch("https://api.kit.forhosting.com/date/weekday-of-new-year", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2026-08-07"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weekday-of-new-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-08-07"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/weekday-of-new-year", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2026-08-07"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2026-08-07"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weekday-of-new-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

{
  "date": "2026-08-07"
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.weekday_of_new_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

Por solicitud$0.002

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.

Ver la documentación completa del KIT →