Compartir a través de

New-TimeSpan

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Crea un objeto TimeSpan.

Sintaxis

New-TimeSpan
   [[-Start] <DateTime>]
   [[-End] <DateTime>]
   [<CommonParameters>]
New-TimeSpan
   [-Days <Int32>]
   [-Hours <Int32>]
   [-Minutes <Int32>]
   [-Seconds <Int32>]
   [<CommonParameters>]

Description

El New-TimeSpan cmdlet crea un objeto TimeSpan que representa un intervalo de tiempo. Puede usar un objeto TimeSpan para agregar o restar la hora de los objetos DateTime .

Sin parámetros, un New-TimeSpan comando devuelve un objeto TimeSpan que representa un intervalo de tiempo de cero.

Ejemplos

Ejemplo 1: Crear un objeto TimeSpan durante una duración especificada

Este comando crea un objeto TimeSpan con una duración de 1 hora y 25 minutos y lo almacena en una variable denominada $TimeSpan. Muestra una representación del objeto TimeSpan .

$TimeSpan = New-TimeSpan -Hours 1 -Minutes 25
$TimeSpan

Days              : 0
Hours             : 1
Minutes           : 25
Seconds           : 0
Milliseconds      : 0
Ticks             : 51000000000
TotalDays         : 0.0590277777777778
TotalHours        : 1.41666666666667
TotalMinutes      : 85
TotalSeconds      : 5100
TotalMilliseconds : 5100000

Ejemplo 2: Crear un objeto TimeSpan para un intervalo de tiempo

En este ejemplo se crea un nuevo objeto TimeSpan que representa el intervalo entre el tiempo en que se ejecuta el comando y el 1 de enero de 2010.

Este comando no requiere el parámetro Start , ya que el valor predeterminado del parámetro Start es la fecha y hora actuales.

New-TimeSpan -End (Get-Date -Year 2010 -Month 1 -Day 1)

Ejemplo 3: Obtener la fecha 90 días a partir de la fecha actual

$90days = New-TimeSpan -Days 90
(Get-Date) + $90days

Estos comandos devuelven la fecha 90 días posterior a la fecha actual.

Ejemplo 4: Detección del intervalo de tiempo desde que se actualizó un archivo

Este comando indica cuánto tiempo ha transcurrido desde la última actualización del archivo de ayuda de about_remote . Puede usar este formato de comando en cualquier archivo o cualquier otro objeto que tenga una propiedad LastWriteTime .

Este comando funciona porque el parámetro Start de New-TimeSpan tiene un alias de LastWriteTime. Cuando canaliza un objeto que tiene una propiedad LastWriteTime a New-TimeSpan, PowerShell usa el valor de la propiedad LastWriteTime como valor del parámetro Start .

Get-ChildItem $PSHOME\en-us\about_remote.help.txt | New-TimeSpan

Days              : 321
Hours             : 21
Minutes           : 59
Seconds           : 22
Milliseconds      : 312
Ticks             : 278135623127728
TotalDays         : 321.916230471907
TotalHours        : 7725.98953132578
TotalMinutes      : 463559.371879547
TotalSeconds      : 27813562.3127728
TotalMilliseconds : 27813562312.7728

Parámetros

-Days

Especifica los días del intervalo de tiempo. El valor predeterminado es 0.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-End

Especifica el final de un intervalo de tiempo. El valor predeterminado es el de la fecha y la hora actuales.

Tipo:DateTime
Posición:1
Valor predeterminado:Current date and time
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Hours

Especifica las horas del intervalo de tiempo. El valor predeterminado es cero.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Minutes

Especifica los minutos del intervalo de tiempo. El valor predeterminado es 0.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Seconds

Especifica la duración del intervalo de tiempo en segundos. El valor predeterminado es 0.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Start

Especifica el inicio de un intervalo de tiempo. Escriba una cadena que represente la fecha y hora, como "3/15/09" o un objeto DateTime , como uno de un Get-Date comando. El valor predeterminado es el de la fecha y la hora actuales.

Puede usar Start o su alias LastWriteTime. El alias LastWriteTime permite canalizar objetos que tienen una propiedad LastWriteTime , como archivos del sistema [System.Io.FileIO]de archivos , al parámetro Start de New-TimeSpan.

Tipo:DateTime
Alias:LastWriteTime
Posición:0
Valor predeterminado:Current date and time
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

DateTime

Puede canalizar un objeto DateTime que represente la hora de inicio a este cmdlet.

Salidas

TimeSpan

Este cmdlet devuelve un objeto que representa el intervalo de tiempo.