TimeSpan.FromHours Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
FromHours(Double) |
Retorna um TimeSpan que representa um número especificado de horas, em que a especificação tem a precisão do milissegundo mais próximo. |
FromHours(Int32) | |
FromHours(Int32, Int64, Int64, Int64, Int64) |
FromHours(Double)
- Origem:
- TimeSpan.cs
- Origem:
- TimeSpan.cs
- Origem:
- TimeSpan.cs
Retorna um TimeSpan que representa um número especificado de horas, em que a especificação tem a precisão do milissegundo mais próximo.
public:
static TimeSpan FromHours(double value);
public static TimeSpan FromHours (double value);
static member FromHours : double -> TimeSpan
Public Shared Function FromHours (value As Double) As TimeSpan
Parâmetros
- value
- Double
Um número de horas, com a precisão do milissegundo mais próximo.
Retornos
Um objeto que representa value
.
Exceções
value
é menor que TimeSpan.MinValue ou maior que TimeSpan.MaxValue.
- ou -
value
é PositiveInfinity.
- ou -
value
é NegativeInfinity.
value
é igual a NaN.
Exemplos
O exemplo a seguir cria vários TimeSpan objetos usando o FromHours método .
// Example of the TimeSpan::FromHours( double ) method.
using namespace System;
void GenTimeSpanFromHours( double hours )
{
// Create a TimeSpan object and TimeSpan string from
// a number of hours.
TimeSpan interval = TimeSpan::FromHours( hours );
String^ timeInterval = interval.ToString();
// Pad the end of the TimeSpan string with spaces if it
// does not contain milliseconds.
int pIndex = timeInterval->IndexOf( ':' );
pIndex = timeInterval->IndexOf( '.', pIndex );
if ( pIndex < 0 )
timeInterval = String::Concat( timeInterval, " " );
Console::WriteLine( "{0,21}{1,26}", hours, timeInterval );
}
int main()
{
Console::WriteLine( "This example of TimeSpan::FromHours( double )\n"
"generates the following output.\n" );
Console::WriteLine( "{0,21}{1,18}", "FromHours", "TimeSpan" );
Console::WriteLine( "{0,21}{1,18}", "---------", "--------" );
GenTimeSpanFromHours( 0.0000002 );
GenTimeSpanFromHours( 0.0000003 );
GenTimeSpanFromHours( 0.0012345 );
GenTimeSpanFromHours( 12.3456789 );
GenTimeSpanFromHours( 123456.7898765 );
GenTimeSpanFromHours( 0.0002777 );
GenTimeSpanFromHours( 0.0166666 );
GenTimeSpanFromHours( 1 );
GenTimeSpanFromHours( 24 );
GenTimeSpanFromHours( 500.3389445 );
}
/*
This example of TimeSpan::FromHours( double )
generates the following output.
FromHours TimeSpan
--------- --------
2E-07 00:00:00.0010000
3E-07 00:00:00.0010000
0.0012345 00:00:04.4440000
12.3456789 12:20:44.4440000
123456.7898765 5144.00:47:23.5550000
0.0002777 00:00:01
0.0166666 00:01:00
1 01:00:00
24 1.00:00:00
500.3389445 20.20:20:20.2000000
*/
// Example of the TimeSpan.FromHours( double ) method.
using System;
class FromHoursDemo
{
static void GenTimeSpanFromHours( double hours )
{
// Create a TimeSpan object and TimeSpan string from
// a number of hours.
TimeSpan interval = TimeSpan.FromHours( hours );
string timeInterval = interval.ToString( );
// Pad the end of the TimeSpan string with spaces if it
// does not contain milliseconds.
int pIndex = timeInterval.IndexOf( ':' );
pIndex = timeInterval.IndexOf( '.', pIndex );
if( pIndex < 0 ) timeInterval += " ";
Console.WriteLine( "{0,21}{1,26}", hours, timeInterval );
}
static void Main( )
{
Console.WriteLine(
"This example of TimeSpan.FromHours( double )\n" +
"generates the following output.\n" );
Console.WriteLine( "{0,21}{1,18}",
"FromHours", "TimeSpan" );
Console.WriteLine( "{0,21}{1,18}",
"---------", "--------" );
GenTimeSpanFromHours( 0.0000002 );
GenTimeSpanFromHours( 0.0000003 );
GenTimeSpanFromHours( 0.0012345 );
GenTimeSpanFromHours( 12.3456789 );
GenTimeSpanFromHours( 123456.7898765 );
GenTimeSpanFromHours( 0.0002777 );
GenTimeSpanFromHours( 0.0166666 );
GenTimeSpanFromHours( 1 );
GenTimeSpanFromHours( 24 );
GenTimeSpanFromHours( 500.3389445 );
}
}
/*
This example of TimeSpan.FromHours( double )
generates the following output.
FromHours TimeSpan
--------- --------
2E-07 00:00:00.0010000
3E-07 00:00:00.0010000
0.0012345 00:00:04.4440000
12.3456789 12:20:44.4440000
123456.7898765 5144.00:47:23.5550000
0.0002777 00:00:01
0.0166666 00:01:00
1 01:00:00
24 1.00:00:00
500.3389445 20.20:20:20.2000000
*/
// Example of the TimeSpan.FromHours( double ) method.
open System
let genTimeSpanFromHours hours =
// Create a TimeSpan object and TimeSpan string from
// a number of hours.
let interval = TimeSpan.FromHours hours
let timeInterval = string interval
// Pad the end of the TimeSpan string with spaces if it
// does not contain milliseconds.
let pIndex = timeInterval.IndexOf ':'
let pIndex = timeInterval.IndexOf('.', pIndex)
let timeInterval =
if pIndex < 0 then timeInterval + " "
else timeInterval
printfn $"{hours,21}{timeInterval,26}"
printfn "This example of TimeSpan.FromHours( double )\ngenerates the following output.\n"
printfn "%21s%18s" "FromHours" "TimeSpan"
printfn "%21s%18s" "---------" "--------"
genTimeSpanFromHours 0.0000002
genTimeSpanFromHours 0.0000003
genTimeSpanFromHours 0.0012345
genTimeSpanFromHours 12.3456789
genTimeSpanFromHours 123456.7898765
genTimeSpanFromHours 0.0002777
genTimeSpanFromHours 0.0166666
genTimeSpanFromHours 1
genTimeSpanFromHours 24
genTimeSpanFromHours 500.3389445
(*
This example of TimeSpan.FromHours( double )
generates the following output.
FromHours TimeSpan
--------- --------
2E-07 00:00:00.0010000
3E-07 00:00:00.0010000
0.0012345 00:00:04.4440000
12.3456789 12:20:44.4440000
123456.7898765 5144.00:47:23.5550000
0.0002777 00:00:01
0.0166666 00:01:00
1 01:00:00
24 1.00:00:00
500.3389445 20.20:20:20.2000000
*)
' Example of the TimeSpan.FromHours( Double ) method.
Module FromHoursDemo
Sub GenTimeSpanFromHours( hours As Double )
' Create a TimeSpan object and TimeSpan string from
' a number of hours.
Dim interval As TimeSpan = _
TimeSpan.FromHours( hours )
Dim timeInterval As String = interval.ToString( )
' Pad the end of the TimeSpan string with spaces if it
' does not contain milliseconds.
Dim pIndex As Integer = timeInterval.IndexOf( ":"c )
pIndex = timeInterval.IndexOf( "."c, pIndex )
If pIndex < 0 Then timeInterval &= " "
Console.WriteLine( "{0,21}{1,26}", hours, timeInterval )
End Sub
Sub Main( )
Console.WriteLine( "This example of " & _
"TimeSpan.FromHours( Double )" & _
vbCrLf & "generates the following output." & vbCrLf )
Console.WriteLine( "{0,21}{1,18}", _
"FromHours", "TimeSpan" )
Console.WriteLine( "{0,21}{1,18}", _
"---------", "--------" )
GenTimeSpanFromHours( 0.0000002 )
GenTimeSpanFromHours( 0.0000003 )
GenTimeSpanFromHours( 0.0012345 )
GenTimeSpanFromHours( 12.3456789 )
GenTimeSpanFromHours( 123456.7898765 )
GenTimeSpanFromHours( 0.0002777 )
GenTimeSpanFromHours( 0.0166666 )
GenTimeSpanFromHours( 1 )
GenTimeSpanFromHours( 24 )
GenTimeSpanFromHours( 500.3389445 )
End Sub
End Module
' This example of TimeSpan.FromHours( Double )
' generates the following output.
'
' FromHours TimeSpan
' --------- --------
' 2E-07 00:00:00.0010000
' 3E-07 00:00:00.0010000
' 0.0012345 00:00:04.4440000
' 12.3456789 12:20:44.4440000
' 123456.7898765 5144.00:47:23.5550000
' 0.0002777 00:00:01
' 0.0166666 00:01:00
' 1 01:00:00
' 24 1.00:00:00
' 500.3389445 20.20:20:20.2000000
Comentários
O value
parâmetro é convertido em milissegundos, que é convertido em tiques, e esse número de tiques é usado para inicializar o novo TimeSpan. Por isso, value
só será considerado somente preciso no milissegundo mais próximo. Observe que, devido à perda de precisão do Double tipo de dados, essa conversão pode gerar um OverflowException para valores próximos, mas ainda no intervalo de MinValue ou MaxValue. Por exemplo, isso faz um OverflowException na tentativa a seguir tentar criar uma instância de um objeto TimeSpan.
// The following throws an OverflowException at runtime
TimeSpan maxSpan = TimeSpan.FromHours(TimeSpan.MaxValue.TotalHours);
// The following throws an OverflowException at runtime
let maxSpan = TimeSpan.FromHours TimeSpan.MaxValue.TotalHours
' The following throws an OverflowException at runtime
Dim maxSpan As TimeSpan = TimeSpan.FromHours(TimeSpan.MaxValue.TotalHours)
Confira também
- Double
- FromTicks(Int64)
- FromMilliseconds(Double)
- FromSeconds(Double)
- FromMinutes(Double)
- FromDays(Double)
Aplica-se a
FromHours(Int32)
FromHours(Int32, Int64, Int64, Int64, Int64)
public static TimeSpan FromHours (int hours, long minutes = 0, long seconds = 0, long milliseconds = 0, long microseconds = 0);
static member FromHours : int * int64 * int64 * int64 * int64 -> TimeSpan
Public Shared Function FromHours (hours As Integer, Optional minutes As Long = 0, Optional seconds As Long = 0, Optional milliseconds As Long = 0, Optional microseconds As Long = 0) As TimeSpan
Parâmetros
- hours
- Int32
- minutes
- Int64
- seconds
- Int64
- milliseconds
- Int64
- microseconds
- Int64
Retornos
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários