Freigeben über


TimeSpan.Zero Field

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared ReadOnly Zero As TimeSpan
public static readonly TimeSpan Zero

Remarks

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.

Examples

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
// Example of the TimeSpan fields.
using System;

class Example
{
   // Pad the end of a TimeSpan string with spaces if it does not 
   // contain milliseconds.
   static string Align(TimeSpan interval)
   {
      string intervalStr = interval.ToString();
      int pointIndex = intervalStr.IndexOf(':');

      pointIndex = intervalStr.IndexOf('.', pointIndex);
      if (pointIndex < 0) intervalStr += "        ";
      return intervalStr;
   }

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      const string numberFmt = "{0,-22}{1,18:N0}";
      const string timeFmt = "{0,-22}{1,26}";

      outputBlock.Text += 
          "This example of the fields of the TimeSpan class" +
          "\ngenerates the following output.\n" + "\n";
      outputBlock.Text += String.Format(numberFmt, "Field", "Value") + "\n";
      outputBlock.Text += String.Format(numberFmt, "-----", "-----") + "\n";

      // Display the maximum, minimum, and zero TimeSpan values.
      outputBlock.Text += String.Format(timeFmt, "Maximum TimeSpan",
          Align(TimeSpan.MaxValue)) + "\n";
      outputBlock.Text += String.Format(timeFmt, "Minimum TimeSpan",
          Align(TimeSpan.MinValue)) + "\n";
      outputBlock.Text += String.Format(timeFmt, "Zero TimeSpan",
          Align(TimeSpan.Zero)) + "\n";
      outputBlock.Text += "\n";

      // Display the ticks-per-time-unit fields.
      outputBlock.Text += String.Format(numberFmt, "Ticks per day",
          TimeSpan.TicksPerDay) + "\n";
      outputBlock.Text += String.Format(numberFmt, "Ticks per hour",
          TimeSpan.TicksPerHour) + "\n";
      outputBlock.Text += String.Format(numberFmt, "Ticks per minute",
          TimeSpan.TicksPerMinute) + "\n";
      outputBlock.Text += String.Format(numberFmt, "Ticks per second",
          TimeSpan.TicksPerSecond) + "\n";
      outputBlock.Text += String.Format(numberFmt, "Ticks per millisecond",
          TimeSpan.TicksPerMillisecond) + "\n";
   }
}

/*
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
*/

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.