Riferimento del formato CSV

È obbligatoria solo la colonna Country. AtlasDays trova le colonne in base al nome dell’intestazione in inglese, quindi l’ordine non conta. I passaggi per importare sono in Importazione CSV.

Colonne

Riga di intestazione consigliata: Country,State,Start Date,End Date,Purpose,Notes. I nomi delle intestazioni non distinguono maiuscole e minuscole. Le colonne non riconosciute, come Days, vengono ignorate. Se un’intestazione compare due volte, viene usata la prima.

Country: Obbligatorio. Nome del paese in inglese o nella lingua dell’app, codice ISO di due lettere o un alias comune come USA, UK, oppure Holland. Un alias che può indicare due luoghi viene rifiutato.
State: Facoltativo, solo per soggiorni negli Stati Uniti. Nome dello stato, abbreviazione postale di due lettere o codice ISO come US-CA. È accettato anche il Distretto di Columbia.
Start Date: Accettato anche come Start. Data nel formato yyyy-mm-dd, oppure un anno di quattro cifre.
End Date: Accettato anche come End. Data nel formato yyyy-mm-dd, oppure un anno di quattro cifre. Vuoto significa in corso (inizio con data esatta) o lo stesso anno (inizio con anno).
Purpose: Personal, Business, Study, oppure Transit, senza distinzione tra maiuscole e minuscole. Combina i valori diversi da Transit con virgole tra virgolette, ad esempio "Business, Personal". I vecchi valori Tourism e Medical vengono importati come Personale. Un valore non riconosciuto viene ignorato senza errore.
Notes: Accettato anche come Note, Notes (optional). Testo libero.
Transit: Colonna legacy. Letta solo se manca la colonna Purpose. Yes, Y, True, oppure 1 contrassegna Transito; No, N, False, 0, oppure vuoto non lo contrassegna.
Start Year, End Year: Colonna legacy. Anni di quattro cifre, usati quando le celle delle date non contengono un anno. Non può essere combinata con date esatte nella stessa riga.

Esempio di importazione CSV e controlli del modello

Formati delle date

Start Date	End Date	Risultato
`2026-03-01`	`2026-03-05`	Soggiorno con date esatte. Per i soggiorni in giornata si usa due volte la stessa data.
`2026-03-01`	vuoto	Soggiorno in corso senza data finale.
`2019`	vuoto	Soggiorno Solo anno per quell’anno.
`2018`	`2019`	Un soggiorno Solo anno che copre il periodo dal 2018 al 2019.
vuoto	vuoto	Soggiorno senza date.

Gli anni devono essere compresi tra il 1900 e otto anni dopo l’anno attuale. Nella stessa riga non si possono mescolare date esatte e valori di anno. I soggiorni Solo anno e senza date contano per i luoghi visitati e la mappa, ma mai per i conteggi dei giorni o i tracker. Un soggiorno senza date può essere creato solo tramite importazione CSV.

Casi particolari

Stati USA. Usa una riga per stato quando una visita negli USA ne comprende diversi. Una semplice riga United States è valida per il monitoraggio a livello di paese. Un nome di stato nella colonna Country (California, US-CA) crea anch’esso un soggiorno USA, così come Country vuoto con State valido. I codici di due lettere che sono anche codici di paese, come CA, restano paesi. Senza Pro, le righe degli stati vengono importate come normali soggiorni negli Stati Uniti.
Transito. Inserisci Transit in Purpose quando non sei entrato nel paese. Transito è esclusivo: se compare con un altro motivo, viene mantenuto solo Transito.
Separatore e virgolette. Virgola, punto e virgola e tabulazione vengono rilevati dalla riga di intestazione. Racchiudi tra virgolette i campi che contengono il separatore o un’interruzione di riga.

Esempio

Country,State,Start Date,End Date,Purpose,Notes
France,,2026-03-01,2026-03-05,Personal,
United States,CA,2026-04-10,2026-04-15,Business,Conference
Japan,,2024,,Personal,Dates not known
United Arab Emirates,,2026-05-01,2026-05-01,Transit,Airport connection

Messaggi di errore

Ogni errore compare nell’anteprima con il numero di riga; la riga non viene importata. Il conteggio considera l’intestazione come riga 1.

Colonna Country non trovata: Inserisci per prima una riga di intestazione con una colonna Country.
Paese non valido: «<valore>»: Usa un codice ISO o un nome di paese non ambiguo.
Stato non valido: «<valore>»: Usa un nome di stato USA, un’abbreviazione o un codice US-XX.
Lo stato «<valore>» è valido solo per soggiorni negli Stati Uniti: Svuota State oppure imposta Country su United States.
Stati in conflitto: Le celle Country e State indicano stati diversi. Mantienine uno solo.
Data iniziale non valida / Data finale non valida: Usa yyyy-mm-dd oppure un anno di quattro cifre.
Anno iniziale non valido / Anno finale non valido: Usa un anno di quattro cifre nell’intervallo consentito.
Non è possibile avere una data finale senza una data iniziale: Aggiungi una Start Date.
La data iniziale deve precedere o coincidere con la data finale: Inverti o correggi le date.
L’anno finale deve essere successivo o uguale all’anno iniziale: Correggi gli anni.
Non è possibile avere un anno finale senza un anno iniziale: Aggiungi un anno iniziale.
Non è possibile mescolare date esatte e campi con anni approssimativi: Usa le date oppure le colonne legacy degli anni.
Non è possibile mescolare una data iniziale esatta con una fine Solo anno, o un inizio Solo anno con una data finale esatta: Usa due date oppure due anni nella stessa riga.
Valore di transito non valido: Nella colonna legacy Transit usa Yes/No, True/False o 1/0.

Se un valore non viene riconosciuto

Usa un codice ISO del paese, date ISO e un nome o codice standard di stato USA. Un file esportato da un foglio di calcolo in un’altra lingua può avere intestazioni tradotte, che non vengono riconosciute: rinominale con le intestazioni in inglese indicate sopra.

Ultimo aggiornamento: 30 settembre 2026