Calculadora de semana EE. UU.
Calcule el número de semana de Estados Unidos de cualquier fecha, con semanas de domingo a sábado y la semana 1 como la del 1 de enero: el 15 de marzo de 2024 cae en la semana 11. También verá cuántas semanas tiene el año. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Fecha
- 2024-03-15
- Año
- 2 024
- Mes
- 3
- Día
- 15
- Día del año
- 75
En Estados Unidos muchos calendarios, sistemas de nómina, planificadores escolares y modelos de hoja de cálculo numeran las semanas de modo que cada una empiece en domingo y la semana uno sea simplemente la que contiene el primero de enero. Esa regla difiere del sistema de fechas de semana ISO 8601, que inicia las semanas en lunes y define la semana uno como la que incluye el primer jueves del año. Cuando un horario, informe o rastro de auditoría debe coincidir con números de semana de EE. UU. y no con los ISO, un conversor determinista pequeño evita rarezas del Date del host y la deriva de configuración regional. Esta calculadora de número de semana EE.
Reglas de semana EE. UU. frente a semanas ISO, y cómo enviar una fecha
Bajo el convenio de EE. UU. usado aquí, una semana siempre empieza en domingo y termina en sábado. La semana uno de un año es la que incluye el primero de enero, aunque esa semana hubiera empezado en diciembre del año anterior en el calendario de pared.
Las semanas posteriores se cuentan como bloques completos de domingo a sábado hasta el treinta y uno de diciembre, que puede caer en la semana cincuenta y dos o cincuenta y tres según dónde cayó el primero de enero y si el año es bisiesto. Las semanas ISO 8601 son distintas: empiezan en lunes, y la semana uno es la del primer jueves del año, de modo que el mismo día civil puede mapear a un índice de semana distinto.
Cómo se calcula el número y qué aspecto tienen las fechas inválidas
El motor primero valida el día del calendario gregoriano, aplicando reglas de año bisiesto de modo que febrero tenga veintinueve días solo cuando el año es divisible por cuatro, salvo que los años de siglo también deban ser divisibles por cuatrocientos. El número de semana EE. UU. es el suelo de día-del-año menos uno más el día de la semana del primero de enero, todo dividido por siete, más uno, donde domingo es el día de la semana cero.
Esa fórmula sitúa el primero de enero en la semana uno y avanza de uno en uno cada domingo siguiente. Cadenas mal formadas que no sean año de cuatro dígitos, mes de dos dígitos y día de dos dígitos separados por guiones se rechazan igual. UU. del treinta y uno de diciembre para que los paneles muestren el rango del año sin una segunda llamada.
Usos habituales y límites prácticos
Use la calculadora gratuita de número de semana EE. UU. en el navegador para comprobaciones de deberes, demos de planificación y verificación rápida sin instalar bibliotecas de calendario. Combine este extremo con herramientas de ordinal ISO o días del mes cuando necesite índices de día o la longitud de febrero, pero no espere que el índice de semana coincida con etiquetas de semana-fecha ISO.
Los límites de año siguen el rango de parámetros publicado por seguridad de aislamiento.
Qué puede hacer con ella
Nómina e informes de semana laboral de EE. UU.
Las canalizaciones de RR. HH. y nómina que agrupan horas por semanas que empiezan en domingo etiquetan cada período de pago con el número de semana EE. UU. que contiene la fecha de trabajo, alineado con las expectativas habituales de WEEKNUM en hojas de cálculo.
Calendarios escolares y de planificación comercial
Los calendarios de distritos y los planes de merchandising a menudo numeran semanas con el 1 de enero en la semana 1; convierta fechas ISO a ese índice para diapositivas, resúmenes por correo y ventanas de inventario.
Preguntas frecuentes
¿Las semanas empiezan en domingo o en lunes?
En domingo. Esta calculadora usa el convenio de EE.
¿Es lo mismo que el número de semana ISO?
No. Las semanas ISO empiezan en lunes y definen la semana 1 por la regla del primer jueves. La misma fecha civil puede dar un índice distinto bajo reglas ISO.
¿Qué ocurre si la fecha no es válida?
Ejemplos: formato YYYY-MM-DD incorrecto, 30 de febrero o 29 de febrero en un año no bisiesto. La validación fallida no se cobra.
¿Es gratuita la calculadora de número de semana EE. UU.?
La herramienta del navegador se ejecuta gratis en su dispositivo.
¿Puede un año tener 53 semanas?
Sí. El 31 de diciembre cae en la semana cincuenta y dos o en la 53, según el día de la semana del 1 de enero y si el año es bisiesto. En 2024, por ejemplo, la última semana es la 53.
Herramientas relacionadas
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/us-week-number \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'const res = await fetch("https://api.kit.forhosting.com/date/us-week-number", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15",
"calendar": "valor-ejemplo"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/us-week-number",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15",
"calendar": "valor-ejemplo"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/us-week-number", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15","calendar":"valor-ejemplo"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15","calendar":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/us-week-number", 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": "2024-03-15",
"calendar": "valor-ejemplo"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.us_week_number",
"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. |
Notas técnicas
UU. acepta una fecha de calendario ISO, aplica aritmética bisiesta gregoriana y una fórmula pura de día de la semana, y devuelve el índice de semana junto con hechos de día de la semana y de año en JSON estable.
Reglas de semana EE. UU. frente a semanas ISO, y cómo enviar una fecha
Envíe una cadena de fecha en forma YYYY-MM-DD, o los campos estructurados year, month y day juntos. Se aceptan alias como calendar, calendar_date e iso_date para la ruta de cadena. La entrada estructurada parcial sin las tres partes se rechaza con invalid_input para que quien llama corrija el cuerpo en lugar de adivinar valores faltantes. Entradas idénticas siempre producen JSON idéntico porque la ruta nunca lee el reloj de pared, la configuración regional ni la red.
Cómo se calcula el número y qué aspecto tienen las fechas inválidas
Fechas imposibles como el treinta y uno de abril, el treinta de febrero o el veintinueve de febrero en un año no bisiesto fallan con invalid_input y un mensaje que indica la longitud real del mes. La respuesta repite week_starts igual a Sunday, week_1_rule igual a contains_january_1, y weeks_in_year igual a la semana EE.
Uso de la API, precios, flujos de trabajo y límites prácticos
Envíe un cuerpo JSON con date como YYYY-MM-DD, o con year, month y day como enteros en los rangos publicados. En éxito la carga útil incluye la fecha normalizada, componentes estructurados, day_of_year, day_of_week de cero para domingo a seis para sábado con un nombre en inglés, week_number, weeks_in_year, is_leap_year, calendar igual a gregorian, y method igual a us_week_number para enrutadores y pruebas que se ramifican por etiquetas. Use la API prepago cuando una exportación de nómina, calendario escolar, herramienta de planificación comercial o SDK necesite un contrato estable bajo saldo KIT a $0.002 por elemento exitoso; los fallos de validación nunca consumen saldo tras el rechazo del motor.
Casos de integración
Paridad de hojas de cálculo en APIs
Los servicios que deben coincidir con números de semana basados en domingo de Excel o Google Sheets exponen un campo JSON estable en lugar de reimplementar la matemática del día de la semana en cada lenguaje cliente.
Preguntas técnicas
¿Cómo obtengo el número de semana EE. UU. de una fecha?
Envíe JSON con date igual a una cadena ISO como 2024-03-15, o envíe year, month y day. La respuesta incluye week_number y day_of_week_name.