ForHosting KIT · Date e tempo

Ore lavorative tra due date e ore

Un ticket aperto venerdì 24 luglio 2026 alle 15:00 UTC e chiuso lunedì 27 alle 11:30 ha richiesto 4,5 ore lavorative, cioè 270 minuti. Il fine settimana e le ore fuori dalla fascia giornaliera restano esclusi. Gratis nel suo browser.

Gratis
Funziona nel suo browser
Senza registrazione
I suoi dati restano sul dispositivo

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Esempio risolto

Se inserisce

Data e ora di inizio: 2026-07-24T15:00:00Z
Data e ora di fine: 2026-07-27T11:30:00Z

Ottiene

Secondi lavorativi: 16.200
Minuti lavorativi: 270
Ore lavorative: 4,5
Inizio della giornata lavorativa: 09:00

Questo calcolatore misura soltanto la parte di un intervallo esplicito che ricade in una fascia lavorativa UTC giornaliera, dal lunedì al venerdì. Accetta date e ore ISO con fuso, converte entrambi gli estremi in UTC con aritmetica deterministica ed esclude sabato e domenica. Lei può mantenere la fascia 09:00–17:00 o indicarne un’altra nello stesso giorno. La risposta contiene secondi esatti e pratici totali in minuti e ore.

Definisca con precisione intervallo e fascia

Il fuso obbligatorio evita che un orario locale indichi istanti diversi su sistemi diversi. L’inizio è incluso e la fine esclusa: gli intervalli consecutivi possono quindi essere sommati senza duplicare il confine. Entrambi i limiti devono appartenere allo stesso giorno UTC e la chiusura deve seguire l’apertura.

I turni notturni vengono rifiutati per non assegnarli in modo ambiguo a un giorno feriale. Conta solo la sovrapposizione effettiva: un intervallo di venerdì può includere le ultime ore, saltare il fine settimana e riprendere lunedì. Le festività non vengono dedotte, poiché cambiano in base a paese, regione, settore e datore di lavoro.

Comprenda il calcolo UTC deterministico

Ogni scostamento viene convertito in un istante UTC mediante aritmetica intera sul calendario gregoriano. Poi attraversa l’insieme limitato di giorni UTC coinvolti. Dal lunedì al venerdì applica una fascia candidata; sabato e domenica non contribuiscono.

Per ogni giorno feriale interseca l’intervallo richiesto con apertura e chiusura e somma i secondi positivi. Estremi uguali producono zero; una fine precedente viene rifiutata.

Usi il risultato nei processi operativi

I team di assistenza possono misurare il tempo lavorativo consumato da un ticket senza imputare notti e fine settimana agli obiettivi interni. Le operations possono confrontare presa in carico e ripristino degli incidenti su un unico orologio, anche con fonti che usano scostamenti diversi. Finanza e servizi professionali possono trasformare attività temporizzate in totali verificabili prima delle proprie regole di fatturazione.

Conservi gli estremi originali, la fascia UTC e i secondi restituiti: il record sarà riproducibile perché il calcolo non dipende dalla data odierna, dal fuso del server o da calendari esterni. Per festività, pause, fine settimana regionali, rotazioni, ora locale stagionale o turni notturni, applichi un livello dedicato. Questo contratto offre una base UTC trasparente, facile da testare, sommare e spiegare.

Casi d'uso

Misurazione degli SLA di assistenza

Conteggi solo il tempo nella fascia lavorativa tra apertura e risoluzione di un ticket.

Rapporti sulla durata degli incidenti

Normalizzi eventi con scostamenti su una fascia UTC ed escluda i fine settimana.

Totali di servizio verificabili

Generi secondi lavorativi deterministici per fatturazione o conformità senza regole locali nascoste.

Domande frequenti

Quali giorni vengono esclusi?

Sono esclusi sabato e domenica UTC. Festività e fine settimana regionali non sono inclusi.

La fascia segue l’ora legale?

No. La fascia è definita in UTC e resta stabile durante i cambi stagionali.

Posso definire un turno notturno?

No. Apertura e chiusura devono ricadere nello stesso giorno UTC, con la chiusura successiva.

L'ora finale viene conteggiata?

No. Il momento iniziale conta e quello finale no, così può sommare intervalli consecutivi, uno per turno o per giorno, senza contare due volte il punto in cui si toccano.

Le date con orario devono indicare il fuso?

Sì. Ognuna deve avere il marcatore UTC o uno scostamento esplicito. Un orario locale senza fuso può indicare istanti diversi su computer diversi, quindi il calcolatore non tira a indovinare e converte tutto in UTC.

Strumenti correlati

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/working-hours-between

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/working-hours-between \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_datetime":"2026-07-24T15:00:00Z","end_datetime":"2026-07-27T11:30:00Z"}'

const res = await fetch("https://api.kit.forhosting.com/date/working-hours-between", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start_datetime": "2026-07-24T15:00:00Z",
    "end_datetime": "2026-07-27T11:30:00Z"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/working-hours-between",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start_datetime": "2026-07-24T15:00:00Z",
    "end_datetime": "2026-07-27T11:30:00Z"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/working-hours-between", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start_datetime":"2026-07-24T15:00:00Z","end_datetime":"2026-07-27T11:30:00Z"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start_datetime":"2026-07-24T15:00:00Z","end_datetime":"2026-07-27T11:30:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/working-hours-between", 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

{
  "start_datetime": "2026-07-24T15:00:00Z",
  "end_datetime": "2026-07-27T11:30:00Z"
}

Esempio di risposta

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

Limiti

max_span_days 36600

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.

Note tecniche

Definisca con precisione intervallo e fascia

Invii `start_datetime` e `end_datetime` come date e ore ISO complete, con `Z` o uno scostamento UTC numerico. La fascia ricorrente predefinita è 09:00–17:00 UTC; Lei può cambiarla tramite `workday_start` e `workday_end` nel formato a 24 ore `HH:MM`.

Comprenda il calcolo UTC deterministico

L’implementazione non crea oggetti `Date`, non legge orologio, impostazioni locali o servizi di fuso e non usa rete né casualità. In questo modo gestisce correttamente il primo e l’ultimo giorno parziali e rende equivalenti scostamenti diversi riferiti allo stesso istante. `working_seconds` è un intero esatto; `working_minutes` e `working_hours` derivano da esso e sono arrotondati a non più di sei decimali per stabilizzare il JSON. La risposta ripete la fascia effettiva e dichiara `timezone` come `UTC`, rendendo visibili le ipotesi.

Usi il risultato nei processi operativi

Il browser serve per controlli singoli; l’API costa $0.002 per richiesta riuscita.

Domande tecniche

Quanto costa?

L’API costa $0.002 per richiesta riuscita; lo stesso calcolo puro può essere eseguito nel browser.

Le date possono usare scostamenti UTC?

Sì. Usi `Z` o uno scostamento esplicito come `-04:00`; ogni estremo viene normalizzato in UTC.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser

Esempio risolto

Definisca con precisione intervallo e fascia

Comprenda il calcolo UTC deterministico

Usi il risultato nei processi operativi

Casi d'uso

Misurazione degli SLA di assistenza

Rapporti sulla durata degli incidenti

Totali di servizio verificabili

Domande frequenti

Strumenti correlati

Per sviluppatori — accesso via API

Endpoint

Chiamala dal tuo stack

Esempio di richiesta

Esempio di risposta

Prezzi

Limiti

Errori

Note tecniche

Definisca con precisione intervallo e fascia

Comprenda il calcolo UTC deterministico

Usi il risultato nei processi operativi

Domande tecniche

grazie