Como: Exibir milissegundos em valores de data e hora

Artigo
03/05/2024

Os métodos de formatação de data e hora padrão, como DateTime.ToString(), incluem as horas, minutos e segundos de um valor de tempo, mas excluem seu componente de milissegundos. Este artigo mostra como incluir um componente de milissegundos de data e hora em cadeias de caracteres formatadas de data e hora.

Para exibir o componente de milissegundos de um valor DateTime

Se você estiver trabalhando com a representação de cadeia de caracteres de uma data, converta-a em um DateTime ou um DateTimeOffset valor usando o método estático DateTime.Parse(String) ou DateTimeOffset.Parse(String) .
Para extrair a representação de cadeia de caracteres do componente de milissegundos de um tempo, chame o método ou o valor de DateTime.ToString(String) data e hora e passe o fffFFF padrão de formato personalizado sozinho ou com outros especificadores de formato personalizados como parâmetroformat.ToString

Gorjeta

A System.Globalization.NumberFormatInfo.NumberDecimalSeparator propriedade especifica o separador de milissegundos.

Exemplo

O exemplo exibe o componente de milissegundos de um DateTime e um DateTimeOffset valor para o console, sozinho e incluído em uma cadeia de caracteres de data e hora mais longa.

using System.Globalization;
using System.Text.RegularExpressions;

string dateString = "7/16/2008 8:32:45.126 AM";

try
{
    DateTime dateValue = DateTime.Parse(dateString);
    DateTimeOffset dateOffsetValue = DateTimeOffset.Parse(dateString);

    // Display Millisecond component alone.
    Console.WriteLine("Millisecond component only: {0}",
                    dateValue.ToString("fff"));
    Console.WriteLine("Millisecond component only: {0}",
                    dateOffsetValue.ToString("fff"));

    // Display Millisecond component with full date and time.
    Console.WriteLine("Date and Time with Milliseconds: {0}",
                    dateValue.ToString("MM/dd/yyyy hh:mm:ss.fff tt"));
    Console.WriteLine("Date and Time with Milliseconds: {0}",
                    dateOffsetValue.ToString("MM/dd/yyyy hh:mm:ss.fff tt"));

    string fullPattern = DateTimeFormatInfo.CurrentInfo.FullDateTimePattern;
    
    // Create a format similar to .fff but based on the current culture.
    string millisecondFormat = $"{NumberFormatInfo.CurrentInfo.NumberDecimalSeparator}fff";

    // Append millisecond pattern to current culture's full date time pattern.
    fullPattern = Regex.Replace(fullPattern, "(:ss|:s)", $"$1{millisecondFormat}");

    // Display Millisecond component with modified full date and time pattern.
    Console.WriteLine("Modified full date time pattern: {0}",
                    dateValue.ToString(fullPattern));
    Console.WriteLine("Modified full date time pattern: {0}",
                    dateOffsetValue.ToString(fullPattern));
}
catch (FormatException)
{
    Console.WriteLine("Unable to convert {0} to a date.", dateString);
}
// The example displays the following output if the current culture is en-US:
//    Millisecond component only: 126
//    Millisecond component only: 126
//    Date and Time with Milliseconds: 07/16/2008 08:32:45.126 AM
//    Date and Time with Milliseconds: 07/16/2008 08:32:45.126 AM
//    Modified full date time pattern: Wednesday, July 16, 2008 8:32:45.126 AM
//    Modified full date time pattern: Wednesday, July 16, 2008 8:32:45.126 AM

Imports System.Globalization
Imports System.Text.REgularExpressions

Module MillisecondDisplay
    Public Sub Main()

        Dim dateString As String = "7/16/2008 8:32:45.126 AM"

        Try
            Dim dateValue As Date = Date.Parse(dateString)
            Dim dateOffsetValue As DateTimeOffset = DateTimeOffset.Parse(dateString)

            ' Display Millisecond component alone.
            Console.WriteLine("Millisecond component only: {0}", _
                              dateValue.ToString("fff"))
            Console.WriteLine("Millisecond component only: {0}", _
                              dateOffsetValue.ToString("fff"))

            ' Display Millisecond component with full date and time.
            Console.WriteLine("Date and Time with Milliseconds: {0}", _
                              dateValue.ToString("MM/dd/yyyy hh:mm:ss.fff tt"))
            Console.WriteLine("Date and Time with Milliseconds: {0}", _
                              dateOffsetValue.ToString("MM/dd/yyyy hh:mm:ss.fff tt"))

            Dim fullPattern As String = DateTimeFormatInfo.CurrentInfo.FullDateTimePattern

            ' Create a format similar to .fff but based on the current culture.
            Dim millisecondFormat as String = $"{NumberFormatInfo.CurrentInfo.NumberDecimalSeparator}fff"
            
            ' Append millisecond pattern to current culture's full date time pattern.
            fullPattern = Regex.Replace(fullPattern, "(:ss|:s)", $"$1{millisecondFormat}")

            ' Display Millisecond component with modified full date and time pattern.
            Console.WriteLine("Modified full date time pattern: {0}", _
                              dateValue.ToString(fullPattern))
            Console.WriteLine("Modified full date time pattern: {0}", _
                              dateOffsetValue.ToString(fullPattern))
        Catch e As FormatException
            Console.WriteLine("Unable to convert {0} to a date.", dateString)
        End Try
    End Sub
End Module
' The example displays the following output if the current culture is en-US:
'    Millisecond component only: 126
'    Millisecond component only: 126
'    Date and Time with Milliseconds: 07/16/2008 08:32:45.126 AM
'    Date and Time with Milliseconds: 07/16/2008 08:32:45.126 AM
'    Modified full date time pattern: Wednesday, July 16, 2008 8:32:45.126 AM
'    Modified full date time pattern: Wednesday, July 16, 2008 8:32:45.126 AM

O fff padrão de formato inclui quaisquer zeros à direita no valor de milissegundos. O FFF padrão de formato os suprime. O exemplo a seguir ilustra a diferença:

DateTime dateValue = new DateTime(2008, 7, 16, 8, 32, 45, 180);
Console.WriteLine(dateValue.ToString("fff"));
Console.WriteLine(dateValue.ToString("FFF"));
// The example displays the following output to the console:
//    180
//    18

Dim dateValue As New Date(2008, 7, 16, 8, 32, 45, 180)
Console.WriteLIne(dateValue.ToString("fff"))
Console.WriteLine(dateValue.ToString("FFF"))
' The example displays the following output to the console:
'    180
'    18

Um problema com a definição de um especificador de formato personalizado completo que inclui o componente de milissegundos de uma data e hora é que ele define um formato codificado que pode não corresponder à disposição dos elementos de tempo na cultura atual do aplicativo. Uma alternativa melhor é recuperar um dos padrões de exibição de data e hora definidos pelo objeto da DateTimeFormatInfo cultura atual e modificá-lo para incluir milissegundos. O exemplo também ilustra esta abordagem. Ele recupera o padrão completo de data e hora da cultura atual da DateTimeFormatInfo.FullDateTimePattern propriedade e, em seguida, insere o padrão fff personalizado junto com o separador de milissegundos da cultura atual. O exemplo usa uma expressão regular para fazer essa operação em uma única chamada de método.

Você também pode usar um especificador de formato personalizado para exibir uma parte fracionária de segundos diferente de milissegundos. Por exemplo, o f especificador de formato personalizado ou F exibe décimos de segundo, o ff especificador de formato personalizado exibe FF centésimos de segundo e o ffff especificador de formato personalizado exibe FFFF dez milésimos de segundo. Partes fracionárias de um milissegundo são truncadas em vez de arredondadas na cadeia de caracteres retornada. Esses especificadores de formato são usados no exemplo a seguir:

DateTime dateValue = new DateTime(2008, 7, 16, 8, 32, 45, 180);
Console.WriteLine("{0} seconds", dateValue.ToString("s.f"));
Console.WriteLine("{0} seconds", dateValue.ToString("s.ff"));
Console.WriteLine("{0} seconds", dateValue.ToString("s.ffff"));
// The example displays the following output to the console:
//    45.1 seconds
//    45.18 seconds
//    45.1800 seconds

Dim dateValue As New DateTime(2008, 7, 16, 8, 32, 45, 180)
Console.WriteLine("{0} seconds", dateValue.ToString("s.f"))
Console.WriteLine("{0} seconds", dateValue.ToString("s.ff"))
Console.WriteLine("{0} seconds", dateValue.ToString("s.ffff"))
' The example displays the following output to the console:
'    45.1 seconds
'    45.18 seconds
'    45.1800 seconds

Nota

É possível exibir unidades fracionárias muito pequenas de um segundo, como dez milésimos de segundo ou centésimos de milésimos de segundo. No entanto, estes valores podem não ser significativos. A precisão de um valor de data e hora depende da resolução do relógio do sistema operacional. Para obter mais informações, consulte a API que seu sistema operacional usa:

Windows 7: GetSystemTimeAsFileTime
Windows 8 e superior: GetSystemTimePreciseAsFileTime
Linux e macOS: clock_gettime

Partilhar via

Como: Exibir milissegundos em valores de data e hora

Para exibir o componente de milissegundos de um valor DateTime

Exemplo

Consulte também

Recursos adicionais