Compartir vía

New-TimeSpan

Módulo:
Microsoft.PowerShell.Utility Module

Crea un objeto TimeSpan.

Sintaxis

Date (Es el valor predeterminado). 

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

Time 

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

Description

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

Sin parámetros, un comando New-TimeSpan 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 de 90 días después de 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 en 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 para , 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.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Time
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-End

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

Propiedades del parámetro

Tipo:DateTime
Valor predeterminado:Current date and time
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Date
Posición:1
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Hours

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Time
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Milliseconds

Especifica la longitud del intervalo de tiempo en milisegundos. El valor predeterminado es 0.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Time
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Minutes

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Time
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Seconds

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Time
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 comando de Get-Date. El valor predeterminado es la fecha y hora actuales.

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

Propiedades del parámetro

Tipo:DateTime
Valor predeterminado:Current date and time
Admite caracteres comodín:False
DontShow:False
Alias:LastWriteTime

Conjuntos de parámetros

Date
Posición:0
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

DateTime

Puede canalizar un objeto DateTime que representa la hora de inicio en este cmdlet.

Salidas

TimeSpan

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