ForHosting KIT · Date e tempo

Giorno della settimana del primo del mese da una data ISO

Inserisca qualsiasi data e scopra in quale giorno della settimana è iniziato il suo mese: il 13 agosto 2026 dà il 1° agosto 2026, un sabato. Ottiene anche il numero ISO del giorno e un indice dalla domenica per costruire calendari. 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: 2026-08-13

Ottiene

Data inserita: 2026-08-13
Prima data: 2026-08-01
Anno: 2026
Mese: 8

Questo calcolatore individua il giorno della settimana in cui è iniziato il mese di una data ISO esplicita. Il giorno inserito può essere qualsiasi giorno del mese; il risultato riguarda sempre il primo. La risposta contiene la prima data canonica, il nome del giorno, il numero ISO e un indice che parte dalla domenica. La convalida gregoriana rigorosa rifiuta le date impossibili.

Inserisca una data ISO completa e inequivocabile

Inserisca nel campo date una data di calendario ISO completa nel formato YYYY-MM-DD. Quattro cifre indicano l’anno, due il mese e due il giorno. Per esempio, 2026-08-13 seleziona agosto 2026, mentre l’ultimo componente dimostra che Lei ha fornito una data reale ed esplicita, non soltanto un mese incompleto.

Lo strumento convalida l’intero valore prima di calcolare il giorno della settimana. I mesi devono essere compresi tra 01 e 12, il giorno deve esistere nel mese indicato e febbraio segue la regola gregoriana degli anni bisestili. In genere è bisestile un anno divisibile per quattro, tranne gli anni secolari non divisibili per quattrocento.

L’intervallo accettato va da 0001 a 9999. Timestamp, suffissi di fuso, date settimanali od ordinali, separatori approssimativi e formati locali vengono rifiutati. Questa rigidità impedisce che valori impossibili come 2023-02-29 o 2026-13-01 siano trasformati in silenzio in un’altra data.

Comprenda il calcolo deterministico del giorno

Dopo la convalida, il risolutore conserva anno e mese e sostituisce intenzionalmente il giorno con uno per il calcolo. Applica una formula gregoriana intera basata su una piccola tabella di scarti mensili, aggiustamenti per gli anni divisibili per quattro, correzioni per i secoli e ripristino per gli anni divisibili per quattrocento. Gennaio e febbraio sono considerati parte dell’anno aritmetico precedente.

Il resto modulo sette produce un indice che inizia dalla domenica: zero indica domenica, uno lunedì e sei sabato. La risposta converte inoltre l’indice nella numerazione ISO, dove lunedì vale uno e domenica sette, e sceglie il nome da una tabella costante. Non viene mai costruita una data di sistema.

Usi il risultato in calendari, resoconti e test

Un’interfaccia di calendario può calcolare quante celle vuote precedono il primo giorno. I resoconti possono indicare il giorno di apertura di ogni periodo contabile e i test possono creare casi stabili senza simulare un orologio né cambiare fuso. Lo strumento non calcola il primo giorno lavorativo, non esclude le festività, non localizza i nomi e non cerca la prima occorrenza di un giorno richiesto.

Risponde soltanto in quale giorno è caduto il primo del mese contenente la data ISO.

Casi d'uso

Creare una griglia mensile

Usi l’indice settimanale per collocare il giorno uno nella colonna corretta e calcolare le celle vuote iniziali.

Etichettare i periodi contabili

Aggiunga il giorno di apertura ai resoconti mensili quando una data di operazione identifica il periodo da descrivere.

Preparare casi di test stabili

Generi risultati deterministici di inizio mese senza leggere l’orologio, creare date locali o impostare un fuso.

Domande frequenti

Il giorno inserito deve essere il primo del mese?

No. È accettata qualsiasi data reale del mese scelto. Il risolutore la convalida e calcola il giorno della settimana relativo al primo.

Il fuso orario può cambiare la risposta?

No. Il calcolo usa aritmetica gregoriana intera e non costruisce mai un Date né consulta le impostazioni locali.

Che cosa accade se fornisco una data impossibile?

Sono inclusi mesi non validi, giorni inesistenti, l’anno 0000 e il 29 febbraio di un anno non bisestile.

Come mi aiuta il risultato a costruire un calendario mensile?

Usi l'indice che parte dalla domenica per contare le caselle vuote prima del giorno 1. Agosto 2026 inizia di sabato, indice 6, quindi una griglia che parte dalla domenica richiede sei caselle vuote.

Che differenza c'è tra i due numeri del giorno?

Il numero ISO va dal lunedì come 1 alla domenica come 7. L'indice dalla domenica va dalla domenica come 0 al sabato come 6. Per un sabato entrambi valgono 6.

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/weekday-of-first-of-month

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/weekday-of-first-of-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-08-13"}'

const res = await fetch("https://api.kit.forhosting.com/date/weekday-of-first-of-month", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2026-08-13"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weekday-of-first-of-month",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-08-13"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2026-08-13"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weekday-of-first-of-month", 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

{
  "date": "2026-08-13"
}

Esempio di risposta

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

Note tecniche

Il calcolo usa aritmetica intera fissa, senza rete, valori casuali, orologio di sistema, conversioni di fuso orario od oggetto Date, così browser e API forniscono risultati deterministici.

Inserisca una data ISO completa e inequivocabile

Una volta superata la convalida, il giorno inserito non cambia la risposta: tutte le date valide dello stesso mese producono gli stessi campi first_date e weekday.

Comprenda il calcolo deterministico del giorno

Ciò evita che una comune API per le date interpreti una stringa priva di orario secondo regole locali, spostando la mezzanotte in un altro giorno. Lo stesso input dipende unicamente dal calendario gregoriano prolettico e restituisce quindi un risultato identico in UTC, in browser configurati con altri fusi e nelle chiamate API future.

Usi il risultato in calendari, resoconti e test

La risposta è adatta sia alla visualizzazione sia all’integrazione software. first_date contiene il valore canonico YYYY-MM-01 del mese scelto. weekday fornisce il nome del giorno, iso_weekday restituisce il numero ISO da uno a sette tra lunedì e domenica, mentre weekday_sunday_zero serve ai sistemi le cui settimane iniziano dalla domenica con indice zero. Sono inclusi anche input_date, year e month, affinché un risultato archiviato resti autoesplicativo. L’esecuzione nel browser è gratuita; le richieste automatiche costano $0.002. Un input errato restituisce invalid_input, distinguendolo da un guasto interno.

Domande tecniche

Che cosa significa iso_weekday?

Segue la numerazione ISO: lunedì è 1, martedì è 2 e domenica è 7. weekday_sunday_zero viene fornito anche per gli elenchi che iniziano di domenica.

Quanto costa una richiesta API?

Una richiesta riuscita costa $0.002. Lo stesso calcolo deterministico può essere eseguito gratuitamente nel browser.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser

Esempio risolto

Inserisca una data ISO completa e inequivocabile

Comprenda il calcolo deterministico del giorno

Usi il risultato in calendari, resoconti e test

Casi d'uso

Creare una griglia mensile

Etichettare i periodi contabili

Preparare casi di test stabili

Domande frequenti

Strumenti correlati

Per sviluppatori — accesso via API

Endpoint

Chiamala dal tuo stack

Esempio di richiesta

Esempio di risposta

Prezzi

Errori

Note tecniche

Inserisca una data ISO completa e inequivocabile

Comprenda il calcolo deterministico del giorno

Usi il risultato in calendari, resoconti e test

Domande tecniche

grazie