ForHosting KIT · Strumenti per sviluppatori

Legga il tempo degli scacchi e ne calcoli la durata massima

I controlli come 90+30 racchiudono due impostazioni fondamentali dell’orologio: i minuti iniziali assegnati a ciascun giocatore e i secondi aggiunti dopo ogni mossa.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Questo calcolatore separa i due valori e stima il tempo massimo disponibile su entrambi gli orologi per un numero indicato di mosse complete. Lei può usarlo per programmare i turni, confrontare cadenze, documentare un torneo o verificare una notazione prima di inserirla nel software di abbinamento o in un calendario pubblico.

Legga correttamente la notazione con incremento

Il controllo 90+30 indica che ogni giocatore parte con 90 minuti e riceve altri 30 secondi dopo aver completato ciascuna mossa. In questo strumento, il valore prima del segno più è sempre espresso in minuti interi, mentre quello successivo è espresso in secondi interi. Inserisca la notazione senza spazi, parole, decimali o fasi aggiuntive. Il servizio accetta volutamente una sola forma chiara, invece di tentare di interpretare un dato approssimativo. 5+3, 15+10 e 90+30 sono quindi inequivocabili; diciture come «rapid 15» o controlli suddivisi in più periodi richiedono regole che la stringa non contiene. La risposta ripete la notazione e presenta base_minutes e increment_seconds come valori distinti, pronti per convalida, archiviazione o ulteriori calcoli deterministici. Una stringa malformata restituisce un errore di input, evitando un risultato credibile ma sbagliato.

Comprenda il calcolo della durata massima

La stima considera entrambi gli orologi. Il tempo iniziale viene prima raddoppiato, perché sia il Bianco sia il Nero ricevono i minuti indicati. L’incremento viene poi moltiplicato per il numero di mosse richiesto e ancora per due, dato che una mossa completa comprende un movimento per ciascun giocatore. Con 40 mosse, il controllo 90+30 include dunque due dotazioni iniziali e fino a 80 incrementi. Il risultato è fornito in secondi, utile per calcoli esatti, e in minuti, più immediato da leggere. È un massimo basato sul tempo assegnato, non una previsione della permanenza reale alla scacchiera. La partita può finire prima, i giocatori possono muovere senza consumare tutto il tempo e le pause organizzative possono prolungare l’evento. Si presume inoltre che ogni movimento conteggiato riceva l’incremento; non vengono modellati delay, penalità, sconfitte per tempo o incrementi attivati dopo una mossa specifica.

Usi il risultato per pianificare e convalidare

Gli organizzatori possono adottare il valore massimo come riferimento prudente per distanziare i turni, aggiungendo margini per ripristinare le scacchiere, pubblicare gli abbinamenti, spostare i partecipanti, gestire decisioni arbitrali e prevedere pause. Gli sviluppatori possono interpretare la notazione al punto di ingresso e memorizzare i due componenti numerici, evitando di dividere la stessa stringa in varie parti dell’applicazione. È anche possibile controllare che il numero di mosse dichiarato sia coerente con il programma. move_count indica mosse complete per ciascun giocatore, non semimosse: 40 rappresenta fino a 40 movimenti del Bianco e 40 del Nero. I valori devono essere interi entro i limiti pubblicati e deve comparire un solo segno più. La base o l’incremento possono essere zero se l’altro componente è positivo; 0+1 e 10+0 sono pertanto validi. 0+0 viene rifiutato perché non assegna tempo giocabile.

Casi d'uso

Pianifichi gli intervalli tra i turni

Stimi il massimo tempo disponibile sui due orologi e aggiunga i margini operativi necessari per il torneo.

Convalidi l’input del software di abbinamento

Rifiuti le notazioni malformate prima di archiviarle o inviarne i componenti al software dell’evento.

Confronti diverse cadenze

Calcoli più controlli con lo stesso numero di mosse per confrontarne il tempo massimo su una base uniforme.

Domande frequenti

Che cosa significa 90+30 negli scacchi?

Ogni giocatore parte con 90 minuti e riceve altri 30 secondi dopo ogni mossa completata.

move_count indica semimosse o mosse complete?

Indica mosse complete per giocatore. Il valore 40 rappresenta 40 movimenti del Bianco e 40 del Nero, fino a 80 incrementi.

Il risultato prevede la durata reale del turno?

No. Indica il massimo assegnato dai due orologi; margini organizzativi e ritardi esterni restano separati.

Il tempo iniziale o l’incremento può essere zero?

Sì, purché l’altro componente sia positivo. 0+1 e 10+0 sono validi, mentre 0+0 viene rifiutato.

Sono supportati i controlli a più fasi?

No. Il parser gestisce una sola fase con base e incremento; aggiungere tempo dopo una mossa specifica richiede un formato diverso.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Lo stesso calcolo deterministico può essere eseguito nel browser, quando disponibile.

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/chess-clock-time-control

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/chess-clock-time-control \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"time_control":"90+30","move_count":40}'

const res = await fetch("https://api.kit.forhosting.com/misc2/chess-clock-time-control", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "time_control": "90+30",
    "move_count": 40
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/misc2/chess-clock-time-control",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "time_control": "90+30",
    "move_count": 40
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/misc2/chess-clock-time-control", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"time_control":"90+30","move_count":40}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"time_control":"90+30","move_count":40}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/misc2/chess-clock-time-control", 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

{
  "time_control": "90+30",
  "move_count": 40
}

Esempio di risposta

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