ForHosting KIT · Strumenti per sviluppatori

Zodiaco cinese dall'anno: animale ed elemento

Inserisca un anno di nascita per determinarne animale ed elemento dello zodiaco cinese nel ciclo tradizionale di 60 anni.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Il risultato affianca ai dodici animali l’elemento Legno, Fuoco, Terra, Metallo o Acqua, la polarità Yin o Yang e il relativo Tronco Celeste e Ramo Terrestre. Il calcolo usa aritmetica modulare fissa: è immediato, ripetibile e adatto a consultazioni, materiali didattici, moduli e applicazioni che richiedono dati zodiacali strutturati senza dipendere da un servizio di calendario.

Comprenda cosa rappresenta il risultato annuale

Lo zodiaco cinese viene spesso descritto come una sequenza ricorrente di dodici animali, ma la denominazione completa di un anno comprende anche uno dei cinque elementi e una polarità Yin o Yang. Queste parti derivano dall’unione dei dodici Rami Terrestri con i dieci Tronchi Celesti. Poiché le sequenze hanno lunghezze diverse, la stessa combinazione completa ritorna solo dopo sessant’anni. La calcolatrice indica animale, elemento, polarità, tronco, ramo e posizione nella sequenza. Due persone nate a dodici anni di distanza condividono normalmente l’animale, ma possono avere elementi diversi perché la successione dei tronchi è proseguita. L’etichetta raccoglie le parti più note, mentre i campi separati sono comodi per software, tabelle, filtri e modelli grafici. Consideri il risultato una classificazione tradizionale dell’anno, non una valutazione scientifica della personalità o una previsione su carattere, compatibilità, salute, fortuna o eventi futuri.

Come viene calcolato il ciclo di 60 anni

Il calcolo assume 1984 come prima posizione del ciclo: l’anno del Topo di Legno Yang, chiamato anche Jia-Zi dal Tronco Celeste e dal Ramo Terrestre. Sottraendo quattro dall’anno indicato si allinea la numerazione gregoriana agli indici iniziali Topo e Jia. Il modulo positivo di dodici seleziona animale e ramo, quello di dieci seleziona tronco, elemento e polarità, mentre quello di sessanta restituisce una posizione da 1 a 60. Il modulo positivo conserva la coerenza anche per anni precedenti agli esempi moderni. Non intervengono orologio corrente, impostazioni locali, rete, casualità o calendari esterni. Lo stesso intero valido produce sempre lo stesso oggetto. Sono accettati numeri interi e stringhe rigorosamente intere, anche con spazi esterni o segno esplicito; vengono rifiutati decimali, notazione esponenziale, valori assenti, interi non sicuri e testi che iniziano soltanto con cifre.

Usi correttamente la risposta nelle applicazioni

Usi il risultato quando un progetto richiede una classificazione zodiacale convenzionale basata soltanto sull’anno gregoriano di nascita. È adatto ad arricchire profili, creare esercizi scolastici, tematizzare eventi, personalizzare biglietti, preparare tabelle di riferimento e aggiungere semplici funzioni culturali. Ricordi che l’anno zodiacale tradizionale cambia al Capodanno lunare, non il 1° gennaio. Chi è nato a gennaio o all’inizio di febbraio potrebbe appartenere all’anno precedente, secondo la data esatta. Poiché questa capacità riceve solo l’anno, non può risolvere quel caso: richieda la data completa e scelga uno strumento basato sul calendario lunare quando serve precisione. Conservi i campi strutturati anziché analizzare l’etichetta, perché sono più semplici da tradurre e interrogare. Ogni richiesta API costa $0.002. Un dato non valido genera un errore esplicito, senza arrotondare decimali, estrarre cifre dal testo o sostituire tacitamente l’anno corrente.

Casi d'uso

Arricchire un profilo dall’anno di nascita

Aggiunga campi strutturati per animale, elemento, polarità, tronco e ramo quando è disponibile soltanto l’anno di nascita.

Creare una tabella didattica del ciclo

Generi esempi coerenti che mostrano come dodici animali e dieci tronchi formino una sequenza ricorrente di 60 anni.

Personalizzare contenuti a tema

Scelga immagini, testi o categorie legati all’anno con un risultato stabile, senza mantenere una tabella separata.

Domande frequenti

Quanto costa una richiesta?

Ogni richiesta API costa $0.002.

Perché il risultato include un elemento oltre all’animale?

L’animale segue dodici rami, mentre l’elemento deriva dai dieci Tronchi Celesti. Insieme partecipano al ciclo completo di 60 anni.

La calcolatrice considera il Capodanno lunare?

No. Associa soltanto il numero dell’anno gregoriano. Le nascite vicine al Capodanno lunare possono richiedere la data esatta e un calcolo lunare.

Posso inviare l’anno come testo?

Sì. È accettata una stringa composta solo da un segno facoltativo e cifre. Decimali, esponenti, valori vuoti o testo misto vengono rifiutati.

Che cos’è la posizione nel ciclo?

È il posto numerato da 1 a 60 nel ciclo ricorrente di tronchi e rami, con 1984 come posizione 1.

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/misc2/chinese-zodiac-from-year

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/misc2/chinese-zodiac-from-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/misc2/chinese-zodiac-from-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 1990
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"year":1990}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/misc2/chinese-zodiac-from-year", 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": 1990
}

Esempio di risposta

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