Stringhe di formato TimeSpan personalizzate

Articolo
03/22/2025

Una stringa di formato TimeSpan definisce la rappresentazione di stringa di un valore TimeSpan risultante da un'operazione di formattazione. Una stringa di formato personalizzata è costituita da uno o più identificatori di formato TimeSpan personalizzati insieme a un numero qualsiasi di caratteri letterali. Qualsiasi stringa non stringa di formato Standard TimeSpan viene interpretata come stringa di formato TimeSpan personalizzata.

Importante

Gli identificatori di formato personalizzati TimeSpan non includono simboli separatori segnaposto, ad esempio i simboli che separano giorni da ore, ore da minuti o secondi dai secondi frazionari. Questi simboli devono invece essere inclusi nella stringa di formato personalizzata come valori letterali stringa. Ad esempio, "dd\.hh\:mm" definisce un punto (.) come separatore tra giorni e ore e due punti (:) come separatore tra ore e minuti.

Gli identificatori di formato personalizzati TimeSpan non includono anche un simbolo di segno che consente di distinguere tra intervalli di tempo negativi e positivi. Per includere un simbolo di segno, è necessario costruire una stringa di formato usando la logica condizionale. La sezione Altri caratteri include un esempio.

Le rappresentazioni di stringa dei valori TimeSpan vengono generate dalle chiamate agli overload del metodo TimeSpan.ToString e dai metodi che supportano la formattazione composita, ad esempio String.Format. Per altre informazioni, vedere Formattazione dei tipi e formattazione composita. Nell'esempio seguente viene illustrato l'uso di stringhe di formato personalizzate nelle operazioni di formattazione.

using System;

public class Example
{
   public static void Main()
   {
      TimeSpan duration = new TimeSpan(1, 12, 23, 62);

      string output = null;
      output = "Time of Travel: " + duration.ToString("%d") + " days";
      Console.WriteLine(output);
      output = "Time of Travel: " + duration.ToString(@"dd\.hh\:mm\:ss");
      Console.WriteLine(output);

      Console.WriteLine($"Time of Travel: {duration:%d} day(s)");
      Console.WriteLine($"Time of Travel: {duration:dd\\.hh\\:mm\\:ss} days");
   }
}
// The example displays the following output:
//       Time of Travel: 1 days
//       Time of Travel: 01.12:24:02
//       Time of Travel: 1 day(s)
//       Time of Travel: 01.12:24:02 days

Module Example
    Public Sub Main()
        Dim duration As New TimeSpan(1, 12, 23, 62)

        Dim output As String = Nothing
        output = "Time of Travel: " + duration.ToString("%d") + " days"
        Console.WriteLine(output)
        output = "Time of Travel: " + duration.ToString("dd\.hh\:mm\:ss")
        Console.WriteLine(output)

        Console.WriteLine("Time of Travel: {0:%d} day(s)", duration)
        Console.WriteLine("Time of Travel: {0:dd\.hh\:mm\:ss} days", duration)
    End Sub
End Module
' The example displays the following output:
'       Time of Travel: 1 days
'       Time of Travel: 01.12:24:02
'       Time of Travel: 1 day(s)
'       Time of Travel: 01.12:24:02 days

Le stringhe di formato TimeSpan personalizzate vengono usate anche dai metodi TimeSpan.ParseExact e TimeSpan.TryParseExact per definire il formato richiesto delle stringhe di input per le operazioni di analisi. L'analisi converte la rappresentazione di stringa di un valore in tale valore. Nell'esempio seguente viene illustrato l'uso di stringhe di formato standard nelle operazioni di analisi.

using System;

public class Example
{
   public static void Main()
   {
      string value = null;
      TimeSpan interval;

      value = "6";
      if (TimeSpan.TryParseExact(value, "%d", null, out interval))
         Console.WriteLine($"{value} --> {interval.ToString("c")}");
      else
         Console.WriteLine($"Unable to parse '{value}'");

      value = "16:32.05";
      if (TimeSpan.TryParseExact(value, @"mm\:ss\.ff", null, out interval))
         Console.WriteLine($"{value} --> {interval.ToString("c")}");
      else
         Console.WriteLine($"Unable to parse '{value}'");

      value= "12.035";
      if (TimeSpan.TryParseExact(value, "ss\\.fff", null, out interval))
         Console.WriteLine($"{value} --> {interval.ToString("c")}");
      else
         Console.WriteLine($"Unable to parse '{value}'");
   }
}
// The example displays the following output:
//       6 --> 6.00:00:00
//       16:32.05 --> 00:16:32.0500000
//       12.035 --> 00:00:12.0350000

Module Example
    Public Sub Main()
        Dim value As String = Nothing
        Dim interval As TimeSpan

        value = "6"
        If TimeSpan.TryParseExact(value, "%d", Nothing, interval) Then
            Console.WriteLine("{0} --> {1}", value, interval.ToString("c"))
        Else
            Console.WriteLine("Unable to parse '{0}'", value)
        End If

        value = "16:32.05"
        If TimeSpan.TryParseExact(value, "mm\:ss\.ff", Nothing, interval) Then
            Console.WriteLine("{0} --> {1}", value, interval.ToString("c"))
        Else
            Console.WriteLine("Unable to parse '{0}'", value)
        End If

        value = "12.035"
        If TimeSpan.TryParseExact(value, "ss\.fff", Nothing, interval) Then
            Console.WriteLine("{0} --> {1}", value, interval.ToString("c"))
        Else
            Console.WriteLine("Unable to parse '{0}'", value)
        End If
    End Sub
End Module
' The example displays the following output:
'       6 --> 6.00:00:00
'       16:32.05 --> 00:16:32.0500000
'       12.035 --> 00:00:12.0350000

La tabella seguente descrive gli identificatori di formato di data e ora personalizzati.

Identificatore di formato	Descrizione	Esempio
"d", "%d"	Numero di giorni interi nell'intervallo di tempo. Altre informazioni: identificatore di formato personalizzato "d".	`new TimeSpan(6, 14, 32, 17, 685):` `%d` -> "6" `d\.hh\:mm` -> "6.14:32"
"dd"-"ddddd"	Numero di giorni interi nell'intervallo di tempo, riempito con zeri iniziali in base alle esigenze. Altre informazioni: identificatori di formato personalizzati "dd"-"ddddd".	`new TimeSpan(6, 14, 32, 17, 685):` `ddd` -> "006" `dd\.hh\:mm` -> "06.14:32"
"h", "%h"	Numero di ore intere nell'intervallo di tempo che non vengono conteggiate come parte dei giorni. Le ore a una sola cifra non hanno uno zero iniziale. Altre informazioni: Identificatore di formato personalizzato "h".	`new TimeSpan(6, 14, 32, 17, 685):` `%h` -> "14" `hh\:mm` -> "14:32"
"hh"	Numero di ore intere nell'intervallo di tempo che non vengono conteggiate come parte dei giorni. Le ore a una sola cifra hanno uno zero iniziale. Altre informazioni: Identificatore di formato personalizzato "hh".	`new TimeSpan(6, 14, 32, 17, 685):` `hh` -> "14" `new TimeSpan(6, 8, 32, 17, 685):` `hh` -> 08
"m", "%m"	Numero di minuti interi nell'intervallo di tempo che non sono inclusi come parte di ore o giorni. I minuti a una sola cifra non hanno uno zero iniziale. Altre informazioni: identificatore di formato personalizzato "m".	`new TimeSpan(6, 14, 8, 17, 685):` `%m` -> "8" `h\:m` -> "14:8"
"mm"	Numero di minuti interi nell'intervallo di tempo che non sono inclusi come parte di ore o giorni. I minuti a cifra singola hanno uno zero iniziale. Altre informazioni: Identificatore di formato personalizzato "mm".	`new TimeSpan(6, 14, 8, 17, 685):` `mm` -> "08" `new TimeSpan(6, 8, 5, 17, 685):` `d\.hh\:mm\:ss` -> 6.08:05:17
"s", "%s"	Numero di secondi interi nell'intervallo di tempo che non sono inclusi come parte di ore, giorni o minuti. I secondi a una sola cifra non hanno uno zero iniziale. Altre informazioni: identificatore di formato personalizzato "s".	`TimeSpan.FromSeconds(12.965)`: `%s` -> 12 `s\.fff` -> 12.965
"ss"	Numero di secondi interi nell'intervallo di tempo che non sono inclusi come parte di ore, giorni o minuti. I secondi a una cifra hanno uno zero iniziale. Altre informazioni: identificatore di formato personalizzato "ss".	`TimeSpan.FromSeconds(6.965)`: `ss` -> 06 `ss\.fff` -> 06.965
"f", "%f"	Decimi di secondo in un intervallo di tempo. Altre informazioni: identificatore di formato personalizzato "f".	`TimeSpan.FromSeconds(6.895)`: `f` -> 8 `ss\.f` -> 06.8
"ff"	Centesimi di secondo in un intervallo di tempo. Altre informazioni: identificatore di formato personalizzato "ff".	`TimeSpan.FromSeconds(6.895)`: `ff` -> 89 `ss\.ff` -> 06.89
"fff"	Millisecondi in un intervallo di tempo. Altre informazioni: identificatore di formato personalizzato "fff".	`TimeSpan.FromSeconds(6.895)`: `fff` -> 895 `ss\.fff` -> 06.895
"ffff"	Diecimilasimi di secondo in un intervallo di tempo. Altre informazioni: Identificatore di formato personalizzato "ffff".	`TimeSpan.Parse("0:0:6.8954321")`: `ffff` -> 8954 `ss\.ffff` -> 06.8954
"fffff"	Centomilasimi di secondo in un intervallo di tempo. Altre informazioni: identificatore di formato personalizzato "fffff".	`TimeSpan.Parse("0:0:6.8954321")`: `fffff` -> 89543 `ss\.fffff` -> 06.89543
"ffffff"	Milionesimi di secondo in un intervallo di tempo. Altre informazioni: Identificatore di formato personalizzato "ffffff".	`TimeSpan.Parse("0:0:6.8954321")`: `ffffff` -> 895432 `ss\.ffffff` -> 06.895432
"fffffff"	I dieci milioni di secondi (o i tick frazionari) in un intervallo di tempo. Altre informazioni: identificatore di formato personalizzato "fffffff".	`TimeSpan.Parse("0:0:6.8954321")`: `fffffff` -> 8954321 `ss\.fffffff` -> 06.8954321
"F", "%F"	Decimi di secondo in un intervallo di tempo. Non viene visualizzato nulla se la cifra è zero. Altre informazioni: Identificatore di formato personalizzato "F".	`TimeSpan.Parse("00:00:06.32")`: `%F`: 3 `TimeSpan.Parse("0:0:3.091")`: `ss\.F`: 03.
"FF"	Centesimi di secondo in un intervallo di tempo. Eventuali zeri finali frazionari o due cifre zero non sono inclusi. Altre informazioni: identificatore di formato personalizzato "FF".	`TimeSpan.Parse("00:00:06.329")`: `FF`: 32 `TimeSpan.Parse("0:0:3.101")`: `ss\.FF`: 03.1
"FFF"	Millisecondi in un intervallo di tempo. Gli zeri finali frazionari non sono inclusi. Ulteriori informazioni:	`TimeSpan.Parse("00:00:06.3291")`: `FFF`: 329 `TimeSpan.Parse("0:0:3.1009")`: `ss\.FFF`: 03.1
"FFFF"	Diecimilasimi di secondo in un intervallo di tempo. Gli zeri finali frazionari non sono inclusi. Altre informazioni: Identificatore di formato personalizzato "FFFF".	`TimeSpan.Parse("00:00:06.32917")`: `FFFFF`: 3291 `TimeSpan.Parse("0:0:3.10009")`: `ss\.FFFF`: 03.1
"FFFFF"	Centomilasimi di secondo in un intervallo di tempo. Gli zeri finali frazionari non sono inclusi. Altre informazioni: identificatore di formato personalizzato "FFFFF".	`TimeSpan.Parse("00:00:06.329179")`: `FFFFF`: 32917 `TimeSpan.Parse("0:0:3.100009")`: `ss\.FFFFF`: 03.1
"FFFFFF"	Milionesimi di secondo in un intervallo di tempo. Gli zeri finali frazionari non vengono visualizzati. Altre informazioni: identificatore di formato personalizzato "FFFFFF".	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 329179 `TimeSpan.Parse("0:0:3.1000009")`: `ss\.FFFFFF`: 03.1
"FFFFFFF"	Dieci milioni di secondi in un intervallo di tempo. Gli zeri finali frazionari o sette zeri non vengono visualizzati. Altre informazioni: identificatore di formato personalizzato "FFFFFFF".	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 3291791 `TimeSpan.Parse("0:0:3.1900000")`: `ss\.FFFFFF`: 03.19
'string'	Delimitatore di stringa letterale. Altre informazioni: Altri caratteri.	`new TimeSpan(14, 32, 17):` `hh':'mm':'ss` -> "14:32:17"
\	Carattere di escape. Altre informazioni: Altri caratteri.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` -> "14:32:17"
Qualsiasi altro carattere	Qualsiasi altro carattere senza caratteri di escape viene interpretato come identificatore di formato personalizzato. Altre informazioni: Altri caratteri.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` -> "14:32:17"

Identificatore di formato personalizzato "d"

L'identificatore di formato personalizzato "d" restituisce il valore della proprietà TimeSpan.Days, che rappresenta il numero di giorni interi nell'intervallo di tempo. Restituisce il numero completo di giorni in un valore TimeSpan, anche se il valore ha più di una cifra. Se il valore della proprietà TimeSpan.Days è zero, l'identificatore restituisce "0".

Se l'identificatore di formato personalizzato "d" viene usato da solo, specificare "%d" in modo che non venga interpretato erroneamente come stringa di formato standard. Di seguito ne viene illustrato un esempio.

TimeSpan ts1 = new TimeSpan(16, 4, 3, 17, 250);
Console.WriteLine(ts1.ToString("%d"));
// Displays 16

Dim ts As New TimeSpan(16, 4, 3, 17, 250)
Console.WriteLine(ts.ToString("%d"))
' Displays 16

Nell'esempio seguente viene illustrato l'uso dell'identificatore di formato personalizzato "d".

TimeSpan ts2 = new TimeSpan(4, 3, 17);
Console.WriteLine(ts2.ToString(@"d\.hh\:mm\:ss"));

TimeSpan ts3 = new TimeSpan(3, 4, 3, 17);
Console.WriteLine(ts3.ToString(@"d\.hh\:mm\:ss"));
// The example displays the following output:
//       0.04:03:17
//       3.04:03:17

Dim ts2 As New TimeSpan(4, 3, 17)
Console.WriteLine(ts2.ToString("d\.hh\:mm\:ss"))

Dim ts3 As New TimeSpan(3, 4, 3, 17)
Console.WriteLine(ts3.ToString("d\.hh\:mm\:ss"))
' The example displays the following output:
'       0.04:03:17
'       3.04:03:17

Condividi tramite

Stringhe di formato TimeSpan personalizzate

Identificatore di formato personalizzato "d"

Identificatori di formato personalizzati "dd"-"dddd"

Identificatore di formato personalizzato "h"

Identificatore di formato personalizzato "hh"

Identificatore di formato personalizzato "m"

Identificatore di formato personalizzato "mm"

Identificatore di formato personalizzato "s"

Identificatore di formato personalizzato "ss"

Identificatore di formato personalizzato "f"

Identificatore di formato personalizzato "ff"

Identificatore di formato personalizzato "fff"

Identificatore di formato personalizzato "ffff"

Identificatore di formato personalizzato "fffff"

Identificatore di formato personalizzato "ffffff"

Identificatore di formato personalizzato "fffffff"

Identificatore di formato personalizzato "F"

Identificatore di formato personalizzato "FF"

Identificatore di formato personalizzato "FFF"

Identificatore di formato personalizzato "FFFF"

Identificatore di formato personalizzato "FFFFF"

Identificatore di formato personalizzato "FFFFFF"

Identificatore di formato personalizzato "FFFFFFF"

Altri caratteri

Vedere anche

Risorse aggiuntive