Estime la fase lunar para cualquier fecha
Este estimador convierte una fecha de calendario en una descripción práctica del ciclo lunar, como luna nueva, creciente, cuarto creciente, luna llena o menguante.
Ejecutar — gratis
También informa la edad lunar aproximada, el porcentaje iluminado y la fracción del ciclo. El cálculo es determinista y emplea un mes sinódico medio contado desde una luna nueva de referencia conocida. No necesita ubicación, consultas de red, servicios astronómicos ni conservar datos del usuario, por lo que resulta útil para planificar y automatizar procesos reproducibles.
Introduzca una fecha gregoriana completa
Indique la fecha exactamente con el formato AAAA-MM-DD, incluidos los ceros iniciales de meses y días de una sola cifra. Por ejemplo, el 8 de abril de 2024 se escribe 2024-04-08. El estimador valida el calendario gregoriano real y no solo la forma del texto, por lo que rechaza fechas imposibles como el 30 de febrero. Los años bisiestos siguen la regla habitual de divisibilidad por cuatro, junto con la excepción de los siglos y la corrección de cada cuatrocientos años. El cálculo toma el mediodía en tiempo universal coordinado como punto de evaluación. Así, cada fecha tiene una referencia constante y el resultado no depende silenciosamente de la zona horaria del equipo. Se admiten años entre 0001 y 9999, expresados con cuatro dígitos. No se interpretan expresiones informales, órdenes regionales, marcas de tiempo ni sufijos horarios. Conviértalos antes al formato documentado. Una entrada estricta garantiza llamadas repetibles y evita interpretaciones distintas de una fecha ambigua como 03/04/2025.
Comprenda cómo se obtiene la estimación
El método parte de una luna nueva conocida del 6 de enero de 2000 a las 18:14 UTC y convierte la fecha solicitada en un día juliano. Calcula el tiempo transcurrido desde esa referencia y lo reduce a un mes sinódico medio de 29.530588853 días. La posición dentro de ese intervalo repetitivo es la fracción del ciclo, mientras que la parte transcurrida se muestra como edad lunar en días. Ocho etiquetas conocidas dividen el ciclo en bandas angulares iguales centradas en luna nueva, cuarto creciente, luna llena y cuarto menguante. La iluminación se estima mediante una curva cosenoidal: comienza cerca del cero por ciento en luna nueva, aumenta hacia el cien por ciento en luna llena y vuelve a disminuir durante la mitad menguante. Los resultados se redondean con precisión estable y práctica. Se trata de un modelo aritmético compacto, no de efemérides. La órbita real varía, por lo que cerca de un límite la observación astronómica precisa puede diferir varias horas y asignar una etiqueta vecina.
Utilice el resultado con la precisión adecuada
Use esta capacidad cuando importe más una estimación rápida y reproducible que la hora exacta de un observatorio. Una agenda puede mostrar una fase reconocible junto a los eventos, un proyecto educativo puede explicar el ciclo repetitivo y una herramienta de planificación puede orientar sobre el brillo nocturno previsto. El campo de fase sirve como categoría legible. La edad y la fracción del ciclo son más útiles para ordenar fechas, crear indicadores visuales o comparar días próximos, mientras que illumination_percent ofrece una medida intuitiva del brillo. Como el algoritmo solo recibe una fecha, no calcula salida, puesta, altura, acimut, eclipses, visibilidad local, meteorología ni orientación aparente del borde iluminado. Esas preguntas necesitan coordenadas geográficas, hora exacta y datos orbitales detallados. No emplee esta aproximación para navegación, seguridad, publicaciones científicas, decisiones religiosas sujetas a observación autorizada ni eventos que dependan del instante exacto de una fase. Para consultas ordinarias y elementos visuales de aplicaciones, es transparente, económica e idéntica en cada ejecución. Puede usarla en el navegador sin llamada al servidor; las solicitudes automatizadas a la API cuestan $0.002 cada una.
Qué puede hacer con ella
Añadir una fase a un calendario
Muestre una fase aproximada junto a los eventos sin consultar un servicio astronómico externo.
Preparar fotografía nocturna informal
Compare fechas por iluminación estimada antes de revisar horas locales y meteorología.
Enseñar el ciclo lunar
Genere ejemplos repetibles de fases crecientes, llenas y menguantes para clases o demostraciones.
Preguntas frecuentes
¿Qué precisión tiene la estimación?
Es apropiada para calendarios generales. Como usa un mes lunar medio y no efemérides completas, la hora exacta puede diferir varias horas.
¿Qué hora del día se utiliza?
El cálculo evalúa la fecha indicada a las 12:00 UTC para no depender de la zona horaria local.
¿Calcula la salida o la puesta de la Luna?
No. Esos horarios requieren una ubicación y un modelo astronómico más detallado.
¿Qué formato de fecha se admite?
Use exactamente AAAA-MM-DD con un mes y un día gregorianos válidos, por ejemplo 2024-04-08.
¿Cuánto cuesta una solicitud a la API?
Cada solicitud a la API cuesta $0.002. La versión del navegador puede ejecutarse localmente sin solicitar la API.
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/misc2/moon-phase-estimate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-04-08"}'const res = await fetch("https://api.kit.forhosting.com/misc2/moon-phase-estimate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-04-08"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/misc2/moon-phase-estimate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-04-08"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/misc2/moon-phase-estimate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-04-08"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-04-08"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/misc2/moon-phase-estimate", 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-04-08"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "misc2.moon_phase_estimate",
"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. |