ForHosting KIT · Utilidades de desarrollo

Número de semanas en un mes

Calcule cuántas semanas naturales ocupa el mes que contiene una fecha ISO concreta.

● BetaGratis · en su navegador

Úselo desde WebAPIEmailTelegramApp pronto

Introduzca una fecha con formato YYYY-MM-DD y elija el día que inicia la semana. El resultado considera la duración del mes, los años bisiestos y las posiciones vacías anteriores al primer día. Así obtiene las filas que el mes necesita en un calendario convencional. La aritmética gregoriana vinculada a UTC evita depender del reloj, la configuración regional o el horario de verano.

Qué significa abarcar semanas naturales

Un mes no contiene un número entero exacto de periodos de siete días, y la expresión «semanas de un mes» puede interpretarse de varias maneras. Esta calculadora cuenta filas semanales: bloques que contienen al menos una fecha del mes seleccionado. Primero localiza el día de la semana del día 1, mide las posiciones anteriores según el inicio elegido, suma los días reales del mes y distribuye el intervalo en filas de siete. Por eso, un mes de 31 días puede ocupar cinco o seis semanas. Febrero, con 28 días, ocupa cuatro filas si comienza justo al inicio semanal, pero cinco si no coincide. Esta definición resulta útil para calendarios mensuales, cuadrantes de personal, planificadores escolares e informes. No equivale a dividir el número de días entre siete: esa operación expresa duración, pero no revela cuántos bloques visuales u operativos atraviesa el mes.

Elija explícitamente el primer día semanal

El campo first_weekday determina los límites de las semanas. Use 0 para domingo, 1 para lunes y continúe hasta 6 para sábado. El valor predeterminado es lunes, habitual en calendarios empresariales orientados a ISO, aunque ninguna convención es universal. Un calendario comercial que empieza en domingo y otro laboral que empieza en lunes pueden ofrecer cifras distintas para el mismo mes. La respuesta repite el valor numérico, su nombre inglés, el día semanal en que comienza el mes y la cantidad de posiciones iniciales. Estos datos permiten auditar el cálculo y detectar discrepancias entre sistemas. La fecha debe escribirse completa y con ceros como YYYY-MM-DD. El día identifica y valida el mes; cambiarlo dentro del mismo mes no altera el recuento. Las fechas imposibles, incluidos los días bisiestos incorrectos, se rechazan en lugar de convertirse silenciosamente en otra fecha.

Aritmética de calendario determinista

El cálculo aplica el calendario gregoriano proléptico entre los años 0001 y 9999. Un año es bisiesto si es divisible por cuatro, salvo los años centenarios que no sean también divisibles por 400. Los días semanales se obtienen mediante enteros: el código no consulta la hora, la red, valores aleatorios ni el objeto Date de JavaScript. La indicación UTC representa una fecha civil estable y neutral; el dato no cambia por la ubicación del servidor ni por el huso del usuario. Un mismo JSON produce siempre la misma respuesta en navegador y API, incluso cerca de cambios de horario. Puede usar el resultado para dimensionar secciones semanales, reservar filas imprimibles, validar calendarios importados o crear cupos de planificación mensual. También se devuelven la duración y el nombre del mes, su primer día semanal y las posiciones iniciales, lo que permite conservar una explicación junto a weeks_in_month. Las solicitudes API parten de $0.002; el navegador utiliza el mismo núcleo determinista.

Qué puede hacer con ella

Dimensionar una cuadrícula mensual

Determine si la vista necesita cuatro, cinco o seis filas semanales antes de mostrarla o imprimirla.

Crear bloques semanales de personal

Genere el número correcto de secciones para un cuadrante mensual conforme al inicio semanal de la organización.

Validar diseños de informes

Compruebe que los informes mensuales asignen cada semana natural que contenga alguna fecha.

Preguntas frecuentes

¿Todos los meses tienen cuatro semanas?

No. Cuatro semanas son exactamente 28 días; la mayoría de los meses tiene más días y puede ocupar cinco o seis filas.

¿Qué significa first_weekday?

Define el límite de cada semana: 0 es domingo, 1 es lunes y los valores continúan hasta 6 para sábado.

¿Por qué cambia el resultado con otro inicio semanal?

Al mover los límites, las primeras y últimas fechas pueden quedar repartidas entre un número diferente de filas.

¿Influye en el resultado el día de la fecha introducida?

Sirve para identificar y validar el mes. Cualquier fecha válida del mismo mes y año da el mismo recuento con igual configuración.

¿Cómo se tratan años bisiestos y husos horarios?

Se aplican reglas gregorianas con enteros. No hay conversión horaria, por lo que la fecha civil se interpreta de forma estable en UTC.

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/weeks-in-month

¿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/weeks-in-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-08-13"}'

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

import os, requests

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

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

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

Ejemplo de respuesta

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