ForHosting KIT · Strumenti per sviluppatori

Durata dell’anno islamico: 354 o 355 giorni

Questo calcolatore stabilisce se un anno del calendario islamico tabulare contiene 354 o 355 giorni.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Inserisca un anno Hijri intero e positivo per ottenere la posizione nel ciclo di 30 anni, lo stato bisestile e il numero esatto di giorni. Il risultato deriva da una regola aritmetica fissa e non dipende da luogo, osservazione lunare, fuso orario, ora corrente o servizi esterni. È adatto a software, calcoli storici, test e attività didattiche che adottano espressamente il calendario tabulare.

Che cosa indica qui un anno Hijri

Il calendario islamico è lunare, ma le sue diverse implementazioni non stabiliscono sempre i confini dei mesi nello stesso modo. Questo strumento usa il calendario islamico tabulare, un modello aritmetico con un ciclo ripetuto di trenta anni. Gli anni comuni hanno 354 giorni, mentre gli anni bisestili prestabiliti ne hanno 355 perché l’ultimo mese riceve un giorno aggiuntivo. La distinzione è importante: un calendario basato sull’osservazione locale della luna crescente, su un annuncio ufficiale o su un modello di visibilità astronomica può assegnare una data civile diversa vicino al cambio di mese. Inserisca un anno Hijri intero e positivo, per esempio 1446. La risposta riporta l’anno originale, la sua posizione da 1 a 30 nel ciclo, l’eventuale stato bisestile e il numero di giorni. Utilizzi questa capacità quando una specifica richiede il calendario islamico tabulare o aritmetico, oppure quando servono risultati riproducibili. Non interpreti il risultato come una decisione religiosa sull’inizio di una ricorrenza in una comunità specifica.

Come viene calcolato il risultato di 354 o 355 giorni

Il calcolo colloca innanzitutto l’anno indicato in una delle trenta posizioni del ciclo tabulare. Le posizioni 2, 5, 7, 10, 13, 16, 18, 21, 24, 26 e 29 sono bisestili; tutte le altre sono comuni. Una posizione bisestile produce 355 giorni, una posizione comune 354. È aritmetica intera esatta, non una stima della fase lunare. L’implementazione non usa l’oggetto Date di JavaScript, non legge l’orologio di sistema, non effettua richieste di rete e non dipende da un database dei fusi orari. Pertanto UTC e le impostazioni locali non possono modificare la risposta. L’input deve essere un intero numerico positivo e sicuro: stringhe numeriche, frazioni, zero, anni negativi, infiniti e interi non sicuri vengono rifiutati. La posizione nel ciclo è inclusa nell’output affinché Lei possa verificare la decisione. La regola trasparente è utile anche per test unitari, migrazioni e controlli di compatibilità tra linguaggi.

Come scegliere il modello di calendario corretto

Utilizzi questo risultato nei sistemi che adottano esplicitamente una cronologia tabulare convenzionale: librerie di conversione configurate per il calendario islamico aritmetico, simulazioni di ricorrenze, dimostrazioni didattiche, convalida di database e calcoli storici in cui la riproducibilità è prioritaria. Se integra dati provenienti da un altro sistema, ne verifichi prima la variante di calendario. Termini come Hijri, islamico, civile, tabulare, Umm al-Qura e osservazionale non sono sempre intercambiabili. Un calendario nazionale ufficiale può applicare criteri astronomici e divergere dal ciclo fisso. Questo endpoint risponde soltanto alla domanda espressa dal nome: quanti giorni ha l’anno Hijri tabulare fornito. Non converte date, non prevede la visibilità della luna crescente, non individua festività e non dichiara l’inizio di un mese in alcuna giurisdizione. Tramite API, ogni richiesta costa $0.002. Poiché la risposta è piccola e deterministica, può memorizzarla per anno, anche se il calcolo diretto è già costante e privo di dipendenze esterne.

Casi d'uso

Convalidare dati di calendario

Verifichi che i conteggi memorizzati rispettino il calendario Hijri aritmetico prima di importare o pubblicare un set di dati.

Creare test deterministici

Generi valori attesi stabili per il software che implementa lo stesso ciclo islamico tabulare di 30 anni.

Spiegare gli anni bisestili

Mostri la posizione nel ciclo, lo stato bisestile e la durata dell’anno senza interrogare un servizio di calendario corrente.

Domande frequenti

Tutti i calendari islamici danno questo risultato?

No. Il calcolatore riguarda solo il calendario islamico tabulare; i calendari osservazionali e ufficiali possono applicare regole diverse.

Quali posizioni del ciclo sono bisestili?

Sono bisestili le posizioni 2, 5, 7, 10, 13, 16, 18, 21, 24, 26 e 29 di ogni ciclo di 30 anni.

Perché un anno Hijri bisestile ha 355 giorni?

Il sistema tabulare aggiunge un giorno all’ultimo mese negli anni bisestili designati, portando il totale da 354 a 355.

UTC o il mio fuso orario cambiano il risultato?

No. Viene usata soltanto aritmetica intera fissa, senza orologio, oggetto Date, fuso orario o servizio esterno.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/date/hijri-year-length

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/date/hijri-year-length \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1446}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"year":1446}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/hijri-year-length", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "year": 1446
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.hijri_year_length",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →