ForHosting KIT · Utilidades de desarrollo

Fecha y día de la semana del Día de la Marmota

El Día de la Marmota siempre se celebra el 2 de febrero, pero el día de la semana cambia cada año.

● BetaGratis · en su navegador

Úselo desde WebAPIEmailTelegramApp pronto

Esta calculadora recibe un año del calendario gregoriano y devuelve la fecha ISO completa, el nombre del día en inglés y valores numéricos útiles. El resultado procede de aritmética calendárica fija, no del reloj del equipo, de una zona horaria ni de un servicio en línea. Por ello sirve tanto para una consulta puntual como para software, publicaciones, planificación de eventos y archivos históricos reproducibles.

Introduzca el año que desea consultar

Indique un año entero del calendario gregoriano entre 1 y 9999. La calculadora fija el mes y el día en el 2 de febrero, porque el Día de la Marmota conserva esa fecha todos los años, y determina después el día de la semana correspondiente. Basta con introducir el año; usted no necesita indicar lugar, hora ni zona horaria. El resultado incluye una fecha ISO con cuatro cifras para el año, el día escrito en inglés, un número ISO donde el lunes es 1 y el domingo es 7, y otro número con origen en domingo, donde este vale 0. Estos campos facilitan mostrar la respuesta o enviarla a otro programa. El motor admite texto formado únicamente por cifras para funcionar con formularios; rechaza valores ausentes, fracciones, signos, palabras y años fuera del intervalo. El cálculo solo responde a una cuestión de calendario: no predice qué verá la marmota, no informa del tiempo ni afirma cuánto durará el invierno.

Cómo se calcula el día de forma determinista

El día se obtiene mediante aritmética entera del calendario gregoriano equivalente al algoritmo de Sakamoto. Febrero utiliza un desplazamiento mensual fijo, y el año seleccionado se ajusta porque enero y febrero se consideran parte del año aritmético anterior. El cálculo incorpora los ciclos bisiestos normales de cuatro años, descarta los años de siglo que no son bisiestos y recupera los siglos divisibles por 400. Un resto final produce un valor de 0 a 6, asociado del domingo al sábado. El número ISO se deriva del mismo resto, de modo que el lunes vale 1 y el domingo 7. No se crea ningún objeto Date de JavaScript. Esto evita heredar por accidente la zona horaria local, interpretar de forma desigual años antiguos o cambiar de día al formatear localmente un valor UTC. La implementación no usa reloj, red, azar, analizador dependiente de la configuración regional ni estado mutable. Una entrada validada idéntica genera por tanto el mismo JSON en el proceso API y en el ejecutor gratuito del navegador.

Use el resultado en calendarios y automatizaciones

La respuesta está preparada para personas y aplicaciones. Un editor puede confirmar el día antes de publicar un artículo anual sobre el Día de la Marmota. Una escuela o un museo puede rotular su programa sin recorrer manualmente un calendario. Una aplicación de eventos puede usar la fecha ISO como clave estable y el nombre del día como texto visible, mientras un análisis agrupa resultados con cualquiera de las dos numeraciones. Como la celebración siempre cae el 2 de febrero, el cálculo es deliberadamente limitado y transparente: no añade reglas de observancia, no sustituye el día ni desplaza la fecha cuando coincide con un fin de semana. Tampoco calcula fiestas regionales de nombre parecido. Para automatizar, cada solicitud representa un año y cuesta $0.002; la versión del navegador permite consultas interactivas sin llamar a la API. Valide y guarde la fecha ISO devuelta en vez de reconstruirla desde el texto, y utilice el campo ISO del día al interoperar con sistemas que siguen la numeración internacional de lunes a domingo.

Qué puede hacer con ella

Planificar un evento anual

Compruebe en qué día cae el 2 de febrero antes de decidir personal, horarios o actividades del fin de semana cercano.

Preparar contenido de temporada

Inserte la fecha y el día correctos en un artículo, boletín, ficha escolar o calendario de redes sociales.

Completar software de calendario

Use la fecha ISO estable y los campos numéricos en procesos de agenda, informes o archivo.

Preguntas frecuentes

¿Qué fecha es el Día de la Marmota?

Siempre es el 2 de febrero. El año determina el día de la semana que devuelve la calculadora.

¿Se desplaza si cae en fin de semana?

No. La capacidad siempre devuelve el 2 de febrero y no aplica reglas de sustitución ni de fiesta observada.

¿Cómo se determina el día de la semana?

Se usa aritmética entera gregoriana proléptica y determinista, incluidas las reglas de años bisiestos y siglos.

¿El cálculo utiliza la zona horaria de usted?

No. Emplea campos calendáricos en términos UTC y nunca consulta un reloj local, una zona horaria ni un objeto Date.

¿Cuánto cuesta una solicitud API?

Un año equivale a un elemento y cuesta $0.002 por solicitud API. La calculadora del navegador permite consultas interactivas.

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/groundhog-day

¿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/groundhog-day \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

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

import os, requests

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

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

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

{
  "year": 2026
}

Ejemplo de respuesta

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

Límites

`year_min`	1
`year_max`	9999

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 →