This topic has not yet been rated - Rate this topic

TimeSpan.Zero Field

April 12, 2014

Represents the zero TimeSpan value. This field is read-only.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
'Declaration
Public Shared ReadOnly Zero As TimeSpan

Because it returns a TimeSpan object that represents a zero time value, the Zero property can be compared with other TimeSpan objects to determine whether the latter represent positive, non-zero, or negative time spans. You can also use this field to initialize a TimeSpan object to a zero time value.

The following code example references and displays the value of the Zero field.


' Example of the TimeSpan fields.

Module Example

   ' Pad the end of a TimeSpan string with spaces if it does not 
   ' contain milliseconds.
   Function Align(ByVal interval As TimeSpan) As String

      Dim intervalStr As String = interval.ToString()
      Dim pointIndex As Integer = intervalStr.IndexOf(":"c)

      pointIndex = intervalStr.IndexOf("."c, pointIndex)
      If pointIndex < 0 Then intervalStr &= "        "
      Align = intervalStr
   End Function

   Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)

      Const numberFmt As String = "{0,-22}{1,18:N0}"
      Const timeFmt As String = "{0,-22}{1,26}"

      outputBlock.Text &= _
          "This example of the fields of the TimeSpan class" & _
          vbCrLf & "generates the following output." & vbCrLf & vbCrLf
      outputBlock.Text &= String.Format(numberFmt, "Field", "Value") & vbCrLf
      outputBlock.Text &= String.Format(numberFmt, "-----", "-----") & vbCrLf

      ' Display the maximum, minimum, and zero TimeSpan values.
      outputBlock.Text &= String.Format(timeFmt, "Maximum TimeSpan", _
          Align(TimeSpan.MaxValue)) & vbCrLf
      outputBlock.Text &= String.Format(timeFmt, "Minimum TimeSpan", _
          Align(TimeSpan.MinValue)) & vbCrLf
      outputBlock.Text &= String.Format(timeFmt, "Zero TimeSpan", _
          Align(TimeSpan.Zero)) & vbCrLf
      outputBlock.Text &= vbCrLf

      ' Display the ticks-per-time-unit fields.
      outputBlock.Text &= String.Format(numberFmt, "Ticks per day", _
          TimeSpan.TicksPerDay) & vbCrLf
      outputBlock.Text &= String.Format(numberFmt, "Ticks per hour", _
          TimeSpan.TicksPerHour) & vbCrLf
      outputBlock.Text &= String.Format(numberFmt, "Ticks per minute", _
          TimeSpan.TicksPerMinute) & vbCrLf
      outputBlock.Text &= String.Format(numberFmt, "Ticks per second", _
          TimeSpan.TicksPerSecond) & vbCrLf
      outputBlock.Text &= String.Format(numberFmt, "Ticks per millisecond", _
          TimeSpan.TicksPerMillisecond) & vbCrLf
   End Sub
End Module

' This example of the fields of the TimeSpan class
' generates the following output.
' 
' Field                              Value
' -----                              -----
' Maximum TimeSpan       10675199.02:48:05.4775807
' Minimum TimeSpan      -10675199.02:48:05.4775808
' Zero TimeSpan                   00:00:00
' 
' Ticks per day            864,000,000,000
' Ticks per hour            36,000,000,000
' Ticks per minute             600,000,000
' Ticks per second              10,000,000
' Ticks per millisecond             10,000


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft. All rights reserved.