TimeSpan.Duration メソッド

.NET Framework クラス ライブラリ リファレンス

TimeSpan.Duration メソッド

値が現在の TimeSpan オブジェクトの絶対値である、新しい TimeSpan オブジェクトを返します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function Duration As
 TimeSpan

Visual Basic (使用法)

Dim instance As TimeSpan
Dim returnValue As TimeSpan

returnValue = instance.Duration

C#

public TimeSpan Duration ()

C++

public:
TimeSpan Duration ()

J#

public TimeSpan Duration ()

JScript

public function Duration () : TimeSpan

戻り値
値が現在の TimeSpan オブジェクトの絶対値である新しい TimeSpan。

例外

例外の種類	条件
OverflowException	このインスタンスの値が、MinValue です。

使用例

複数の TimeSpan オブジェクトに Duration メソッドを適用するコード例を次に示します。

Visual Basic

' Example of the TimeSpan.Duration( ) and TimeSpan.Negate( ) methods
,
' and the TimeSpan Unary Negation and Unary Plus operators.
Imports System
Imports Microsoft.VisualBasic

Module DuraNegaUnaryDemo

    Const dataFmt As String
 = "{0,22}{1,22}{2,22}"

    Sub ShowDurationNegate( interval As TimeSpan
 )

        ' Display the TimeSpan value and the results of the 
        ' Duration and Negate methods.
        Console.WriteLine( dataFmt, _
            interval, interval.Duration( ), interval.Negate( ) )
    End Sub

    Sub Main( )

        Console.WriteLine( _
            "This example of TimeSpan.Duration( ), "
 & _
            "TimeSpan.Negate( ), " & vbCrLf &
 _
            "and the TimeSpan Unary Negation and "
 & _
            "Unary Plus operators " & vbCrLf &
 _
            "generates the following output." &
 vbCrLf )
        Console.WriteLine( dataFmt, _
            "TimeSpan", "Duration(
 )", "Negate( )" )    
        Console.WriteLine( dataFmt, _
            "--------", "-----------",
 "---------" )    

        ' Create TimeSpan objects and apply the Unary Negation
        ' and Unary Plus operators to them.
        ShowDurationNegate( new TimeSpan( 1 ) )
        ShowDurationNegate( new TimeSpan( -1234567 ) )
        ShowDurationNegate( TimeSpan.op_UnaryPlus( _
            new TimeSpan( 0, 0, 10, -20, -30 ) ) )
        ShowDurationNegate( TimeSpan.op_UnaryPlus( _
            new TimeSpan( 0, -10, 20, -30, 40 ) ) )
        ShowDurationNegate( TimeSpan.op_UnaryNegation( _
            new TimeSpan( 1, 10, 20, 40, 160 ) ) )
        ShowDurationNegate( TimeSpan.op_UnaryNegation( _
            new TimeSpan( -10, -20, -30, -40, -50 ) ) )
    End Sub 
End Module 

' This example of TimeSpan.Duration( ), TimeSpan.Negate( ),
' and the TimeSpan Unary Negation and Unary Plus operators
' generates the following output.
' 
'               TimeSpan           Duration( )             Negate( )
'               --------           -----------             ---------
'       00:00:00.0000001      00:00:00.0000001     -00:00:00.0000001
'      -00:00:00.1234567      00:00:00.1234567      00:00:00.1234567
'       00:09:39.9700000      00:09:39.9700000     -00:09:39.9700000
'      -09:40:29.9600000      09:40:29.9600000      09:40:29.9600000
'    -1.10:20:40.1600000    1.10:20:40.1600000    1.10:20:40.1600000
'    10.20:30:40.0500000   10.20:30:40.0500000  -10.20:30:40.0500000

C#

// Example of the TimeSpan.Duration( ) and TimeSpan.Negate( ) methods
,
// and the TimeSpan Unary Negation and Unary Plus operators.
using System;

class DuraNegaUnaryDemo
{
    const string dataFmt = "{0,22}{1,22}{2,22}"
 ;

    static void ShowDurationNegate( TimeSpan
 interval )
    {
        // Display the TimeSpan value and the results of the 
        // Duration and Negate methods.
        Console.WriteLine( dataFmt, 
            interval, interval.Duration( ), interval.Negate( ) );
    }

    static void Main()
    {
        Console.WriteLine(
            "This example of TimeSpan.Duration( ), " +
            "TimeSpan.Negate( ), \nand the TimeSpan Unary " +
            "Negation and Unary Plus operators \n" +
            "generates the following output.\n" );
        Console.WriteLine( dataFmt, 
            "TimeSpan", "Duration( )", "Negate( )"
 );
        Console.WriteLine( dataFmt, 
            "--------", "-----------", "---------"
 );

        // Create TimeSpan objects and apply the Unary Negation
        // and Unary Plus operators to them.
        ShowDurationNegate( new TimeSpan( 1 ) );
        ShowDurationNegate( new TimeSpan( -1234567 ) );
        ShowDurationNegate( 
            + new TimeSpan( 0, 0, 10, -20, -30 ) );
        ShowDurationNegate( 
            + new TimeSpan( 0, -10, 20, -30, 40 ) );
        ShowDurationNegate( 
            - new TimeSpan( 1, 10, 20, 40, 160 ) );
        ShowDurationNegate( 
            - new TimeSpan( -10, -20, -30, -40, -50 ) );
    } 
} 

/*
This example of TimeSpan.Duration( ), TimeSpan.Negate( ),
and the TimeSpan Unary Negation and Unary Plus operators
generates the following output.

              TimeSpan           Duration( )             Negate( )
              --------           -----------             ---------
      00:00:00.0000001      00:00:00.0000001     -00:00:00.0000001
     -00:00:00.1234567      00:00:00.1234567      00:00:00.1234567
      00:09:39.9700000      00:09:39.9700000     -00:09:39.9700000
     -09:40:29.9600000      09:40:29.9600000      09:40:29.9600000
   -1.10:20:40.1600000    1.10:20:40.1600000    1.10:20:40.1600000
   10.20:30:40.0500000   10.20:30:40.0500000  -10.20:30:40.0500000
*/ 

C++

// Example of the TimeSpan::Duration( ) and TimeSpan::Negate( ) methods
,
// and the TimeSpan Unary Negation and Unary Plus operators.
using namespace System;
const __wchar_t * protoFmt = L"{0,22}{1,22}{2,22}";
void ShowDurationNegate( TimeSpan interval )
{
   
   // Display the TimeSpan value and the results of the 
   // Duration and Negate methods.
   Console::WriteLine( gcnew String( protoFmt ), interval, interval.Duration(), interval.Negate()
 );
}

int main()
{
   Console::WriteLine( "This example of TimeSpan::Duration( ), "
   "TimeSpan::Negate( ), \nand the TimeSpan Unary "
   "Negation and Unary Plus operators \n"
   "generates the following output.\n" );
   Console::WriteLine( gcnew String( protoFmt ), "TimeSpan", "Duration(
 )", "Negate( )" );
   Console::WriteLine( gcnew String( protoFmt ), "--------", "-----------",
 "---------" );
   
   // Create TimeSpan objects and apply the Unary Negation
   // and Unary Plus operators to them.
   ShowDurationNegate( TimeSpan(1) );
   ShowDurationNegate( TimeSpan( -1234567) );
   ShowDurationNegate(  +TimeSpan(0,0,10,-20,-30) );
   ShowDurationNegate(  +TimeSpan(0,-10,20,-30,40) );
   ShowDurationNegate(  -TimeSpan(1,10,20,40,160) );
   ShowDurationNegate(  -TimeSpan( -10,-20,-30,-40,-50) );
}

/*
This example of TimeSpan::Duration( ), TimeSpan::Negate( ),
and the TimeSpan Unary Negation and Unary Plus operators
generates the following output.

              TimeSpan           Duration( )             Negate( )
              --------           -----------             ---------
      00:00:00.0000001      00:00:00.0000001     -00:00:00.0000001
     -00:00:00.1234567      00:00:00.1234567      00:00:00.1234567
      00:09:39.9700000      00:09:39.9700000     -00:09:39.9700000
     -09:40:29.9600000      09:40:29.9600000      09:40:29.9600000
   -1.10:20:40.1600000    1.10:20:40.1600000    1.10:20:40.1600000
   10.20:30:40.0500000   10.20:30:40.0500000  -10.20:30:40.0500000
*/

J#

// Example of the TimeSpan.Duration( ) and TimeSpan.Negate( ) methods
,
// and the TimeSpan Unary Negation and Unary Plus operators.
import System.*;

class DuraNegaUnaryDemo
{
    private static String dataFmt = "{0
,22}{1,22}{2,22}";

    static void ShowDurationNegate(TimeSpan
 interval)
    {
        // Display the TimeSpan value and the results of the 
        // Duration and Negate methods.
        Console.WriteLine(dataFmt, interval, interval.Duration(),
            interval.Negate());
    } //ShowDurationNegate

    public static void main(String[]
 args)
    {
        Console.WriteLine(("This example of TimeSpan.Duration( ), " 
            + "TimeSpan.Negate( ), \nand the TimeSpan Unary " 
            + "Negation and Unary Plus operators \n" 
            + "generates the following output.\n"));
        Console.WriteLine(dataFmt, "TimeSpan", "Duration( )",
 "Negate( )");
        Console.WriteLine(dataFmt, "--------", "-----------",
 "---------");

        // Create TimeSpan objects and apply the Unary Negation
        // and Unary Plus operators to them.
        ShowDurationNegate(new TimeSpan(1));
        ShowDurationNegate(new TimeSpan(-1234567));
        ShowDurationNegate(new TimeSpan(0, 0, 10, -20, -30));
        ShowDurationNegate(new TimeSpan(0, -10, 20, -30, 40));
        ShowDurationNegate(new TimeSpan(1, 10, 20, 40, 160).Negate());
        ShowDurationNegate(new TimeSpan(-10, -20, -30, -40, -50).Negate());
    } //main
} //DuraNegaUnaryDemo

/*
This example of TimeSpan.Duration( ), TimeSpan.Negate( ),
and the TimeSpan Unary Negation and Unary Plus operators
generates the following output.

              TimeSpan           Duration( )             Negate( )
              --------           -----------             ---------
      00:00:00.0000001      00:00:00.0000001     -00:00:00.0000001
     -00:00:00.1234567      00:00:00.1234567      00:00:00.1234567
      00:09:39.9700000      00:09:39.9700000     -00:09:39.9700000
     -09:40:29.9600000      09:40:29.9600000      09:40:29.9600000
   -1.10:20:40.1600000    1.10:20:40.1600000    1.10:20:40.1600000
   10.20:30:40.0500000   10.20:30:40.0500000  -10.20:30:40.0500000
*/

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
TimeSpan 構造体
TimeSpan メンバ
System 名前空間
Ticks