Crea un objeto TimeSpan.

Sintaxis

New-TimeSpan [[-Start] <DateTime>] [[-End] <DateTime>] [<CommonParameters>]

New-TimeSpan [-Days <int>] [-Hours <int>] [-Minutes <int>] [-Seconds <int>] [<CommonParameters>]

Descripción

El cmdlet New-TimeSpan crea un objeto TimeSpan que representa un intervalo de tiempo. Este objeto puede usarse para sumar o restar tiempo de los objetos DateTime.

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

Parámetros

-Days <int>

Indica los días de un intervalo de tiempo. El valor predeterminado es 0.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

0

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-End <DateTime>

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

¿Requerido?

false

¿Posición?

2

Valor predeterminado

Current date and time

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

false

-Hours <int>

Indica las horas de un intervalo de tiempo. El valor predeterminado es cero.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

0

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Minutes <int>

Indica los minutos de un intervalo de tiempo. El valor predeterminado es 0.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

0

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Seconds <int>

Indica el intervalo de tiempo en segundos. El valor predeterminado es 0.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

0

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Start <DateTime>

Indica el inicio de un intervalo de tiempo. Escriba una cadena que representa la fecha y la hora, como "3/15/09" o un objeto DateTime, como el de un comando Get-Date.

El valor predeterminado es la fecha y la hora actuales.

¿Requerido?

false

¿Posición?

1

Valor predeterminado

Current date and time

¿Aceptar canalización?

true (ByValue, ByPropertyName)

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.DateTime

Puede canalizar a New-TimeSpan un objeto DateTime que representa la hora de inicio.

Salidas

System.Timespan

New-TimeSpan devuelve un objeto que representa el intervalo de tiempo.

Ejemplo 1

C:\PS>$timespan = new-timespan -hour 1 -minute 25

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






Ejemplo 2

C:\PS>new-timespan -end (get-date -year 2010 -month 1 -day 1)

Descripción
-----------
En este ejemplo, se crea un nuevo objeto TimeSpan que representa el intervalo de tiempo comprendido entre la ejecución del comando y el 1 de enero de 2010.

Este comando no requiere el parámetro Start porque el valor predeterminado de este parámetro es la fecha y la hora actuales.






Ejemplo 3

C:\PS>$90days = new-timespan -days 90

C:\PS> (get-date) + $90days

Descripción
-----------
Estos comandos devuelven la fecha correspondiente a 90 días después de la fecha actual.






Vea también




Tabla de contenido