Clase `CFileTime`

Artículo
10/12/2023

Esta clase proporciona métodos para administrar los valores de fecha y hora asociados a un archivo.

Sintaxis

class CFileTime :  public FILETIME

Miembros

Constructores públicos

Nombre	Descripción
`CFileTime::CFileTime`	Constructor .

Métodos públicos

Nombre	Descripción
`CFileTime::GetCurrentTime`	Llame a esta función estática para recuperar un objeto `CFileTime` que representa la fecha y hora actuales del sistema.
`CFileTime::GetTime`	Llame a este método para recuperar el tiempo del objeto `CFileTime`.
`CFileTime::LocalToUTC`	Llame a este método para convertir una hora de archivo local en una hora de archivo en función de la hora universal coordinada (UTC).
`CFileTime::SetTime`	Llame a este método para establecer la fecha y la hora almacenadas por el objeto `CFileTime`.
`CFileTime::UTCToLocal`	Llame a este método para convertir la hora en función de la hora universal coordinada (UTC) a la hora del archivo local.

Operadores públicos

Nombre	Descripción
`CFileTime::operator -`	Este operador se usa para restar en un objeto `CFileTime` o `CFileTimeSpan`.
`CFileTime::operator !=`	Este operador compara dos objetos `CFileTime` para determinar si son diferentes.
`CFileTime::operator +`	Este operador se usa para sumar en un objeto `CFileTimeSpan`.
`CFileTime::operator +=`	Este operador se usa para sumar en un objeto `CFileTimeSpan` y asignar el resultado al objeto actual.
`CFileTime::operator <`	Este operador compara dos objetos `CFileTime` para determinar el menor.
`CFileTime::operator <=`	Este operador compara dos objetos `CFileTime` para determinar si son iguales o cuál es el menor.
`CFileTime::operator =`	Operador de asignación.
`CFileTime::operator -=`	Este operador se usa para restar en un objeto `CFileTimeSpan` y asignar el resultado al objeto actual.
`CFileTime::operator ==`	Este operador compara dos objetos `CFileTime` para determinar si son iguales.
`CFileTime::operator >`	Este operador compara dos objetos `CFileTime` para determinar el mayor.
`CFileTime::operator >=`	Este operador compara dos objetos `CFileTime` para determinar si son iguales o cuál es el mayor.

Constantes públicas

Nombre	Descripción
`CFileTime::Day`	Miembro de datos estático que almacena el número de intervalos de 100 nanosegundos que componen un día.
`CFileTime::Hour`	Miembro de datos estático que almacena el número de intervalos de 100 nanosegundos que componen una hora.
`CFileTime::Millisecond`	Miembro de datos estático que almacena el número de intervalos de 100 nanosegundos que componen un milisegundo.
`CFileTime::Minute`	Miembro de datos estáticos que almacena el número de intervalos de 100 nanosegundos que componen un minuto.
`CFileTime::Second`	Miembro de datos estático que almacena el número de intervalos de 100 nanosegundos que componen un segundo.
`CFileTime::Week`	Miembro de datos estático que almacena el número de intervalos de 100 nanosegundos que componen una semana.

Comentarios

Esta clase proporciona métodos para administrar los valores de fecha y hora asociados a la creación, el acceso y la modificación de los archivos. Los métodos y datos de esta clase se usan con frecuencia junto con objetos CFileTimeSpan, que tratan con valores de tiempo relativos.

El valor de fecha y hora se almacena como un valor de 64 bits que representa el número de intervalos de 100 nanosegundos desde el 1 de enero de 1601. Este formato es el formato de hora universal coordinada (UTC).

Se proporcionan las siguientes variables miembro const estáticas para simplificar los cálculos:

Variable miembro	Número de intervalos de 100 nanosegundos
Millisecond	10 000
Second	Millisecond * 1000
Minute	Second * 60
Hora	Minute * 60
Día	Hour * 24
Semana	Day * 7

Nota:

No todos los sistemas de archivos pueden registrar la creación y la hora de último acceso y no todos los sistemas de archivos los registran de la misma forma. Por ejemplo, en el sistema de archivos FAT de Windows NT, el tiempo de creación tiene una resolución de 10 milisegundos, el tiempo de escritura tiene una resolución de 2 segundos y el tiempo de acceso tiene una resolución de 1 día (la fecha de acceso). En NTFS, el tiempo de acceso tiene una resolución de 1 hora. Además, FAT registra las horas en el disco en la hora local, pero NTFS registra las horas en el disco en UTC. Para más información, consulte Tiempos de archivo.

Jerarquía de herencia

FILETIME
└ CFileTime

Requisitos

Encabezado: atltime.h

`CFileTime::CFileTime`

Constructor .

CFileTime() throw();
CFileTime(const FILETIME& ft) throw();
CFileTime(ULONGLONG nTime) throw();

Parámetros

ft
Un estructura FILETIME.

nTime
Fecha y hora expresadas como un valor de 64 bits.

Comentarios

El objeto CFileTime se puede crear con una fecha y hora existentes a partir de una estructura FILETIME, o expresarse como un valor de 64 bits (en formatos de hora universal coordinada o local [UTC]). El constructor predeterminado establece la hora en 0.

`CFileTime::Day`

Miembro de datos estático que almacena el número de intervalos de 100 nanosegundos que componen un día.

static const ULONGLONG Day = Hour* 24;

Ejemplo

Vea el ejemplo de CFileTime::Millisecond.

`CFileTime::GetCurrentTime`

Llame a esta función estática para recuperar un objeto CFileTime que representa la fecha y hora actuales del sistema.

static CFileTime GetCurrentTime() throw();

Valor devuelto

Devuelve la fecha y hora actuales del sistema en formato de hora universal coordinada (UTC).

Ejemplo

// Retrieve the current time
CFileTime myFT;
myFT = CFileTime::GetCurrentTime();

`CFileTime::GetTime`

Llame a este método para recuperar el tiempo del objeto CFileTime.

ULONGLONG GetTime() const throw();

Valor devuelto

Devuelve la fecha y hora como un número de 64 bits, que puede estar en formato local u hora universal coordinada (UTC).

`CFileTime::Hour`

Miembro de datos estático que almacena el número de intervalos de 100 nanosegundos que componen una hora.

static const ULONGLONG Hour = Minute* 60;

Ejemplo

Vea el ejemplo de CFileTime::Millisecond.

`CFileTime::LocalToUTC`

Llame a este método para convertir una hora de archivo local en una hora de archivo en función de la hora universal coordinada (UTC).

CFileTime LocalToUTC() const throw();

Valor devuelto

Devuelve un objeto CFileTime que contiene la hora en formato UTC.

Ejemplo

Vea el ejemplo de CFileTime::UTCToLocal.

`CFileTime::Millisecond`

Miembro de datos estático que almacena el número de intervalos de 100 nanosegundos que componen un milisegundo.

static const ULONGLONG Millisecond = 10000;

Ejemplo

// Calculate the difference between two times
CFileTime myFT1, myFT2;
CFileTimeSpan myFTS;

// Get the first time
myFT1 = CFileTime::GetCurrentTime();

// Pause for a moment
UINT randVal;
rand_s(&randVal);
Sleep(randVal % 10000);

// Get the second time
myFT2 = CFileTime::GetCurrentTime();

// Calculate the time difference
myFTS = myFT2 - myFT1;

// Measure the difference
if (myFTS.GetTimeSpan() < CFileTime::Minute)
   printf_s("Less than a minute passed\n");
else
   printf_s("A minute or more passed\n");

if (myFTS.GetTimeSpan() < CFileTime::Second)
   printf_s("Less than a second passed\n");
else
   printf_s("A second or more passed\n");

if (myFTS.GetTimeSpan() < CFileTime::Millisecond)
   printf_s("Less than a millisecond passed\n");
else
   printf_s("A millisecond or more passed\n");

`CFileTime::Minute`

Miembro de datos estáticos que almacena el número de intervalos de 100 nanosegundos que componen un minuto.

static const ULONGLONG Minute = Second* 60;

Ejemplo

Vea el ejemplo de CFileTime::Millisecond.

`CFileTime::operator -`

Este operador se usa para restar en un objeto CFileTime o CFileTimeSpan.

CFileTime operator-(CFileTimeSpan span) const throw();
CFileTimeSpan operator-(CFileTime ft) const throw();

Parámetros

span
Un objeto CFileTimeSpan.

ft
Un objeto CFileTime.

Valor devuelto

Devuelve un objeto CFileTime o un objeto CFileTimeSpan que representa el resultado de la diferencia de tiempo entre los dos objetos.

`CFileTime::operator !=`

Este operador compara dos objetos CFileTime para determinar si son diferentes.

bool operator!=(CFileTime ft) const throw();

Parámetros

ft
Objeto CFileTime que se va a comparar.

Valor devuelto

Devuelve TRUE si el elemento que se va a comparar no es igual al objeto CFileTime; de lo contrario, FALSE.

`CFileTime::operator +`

Este operador se usa para sumar en un objeto CFileTimeSpan.

CFileTime operator+(CFileTimeSpan span) const throw();

Parámetros

span
Un objeto CFileTimeSpan.

Valor devuelto

Devuelve un objeto CFileTime que representa el resultado de la hora original más una hora relativa.

`CFileTime::operator +=`

Este operador se usa para sumar en un objeto CFileTimeSpan y asignar el resultado al objeto actual.

CFileTime& operator+=(CFileTimeSpan span) throw();

Parámetros

span
Un objeto CFileTimeSpan.

Valor devuelto

Devuelve un objeto CFileTime actualizado, que representa el resultado de la hora original más una hora relativa.

`CFileTime::operator <`

Este operador compara dos objetos CFileTime para determinar el menor.

bool operator<(CFileTime ft) const throw();

Parámetros

ft
Objeto CFileTime que se va a comparar.

Valor devuelto

Devuelve TRUE si el primer objeto es menos (antes en tiempo) que el segundo; de lo contrario, FALSE.

Ejemplo

// Test for one time less than another
// Declare the CFileType objects
CFileTime myFT1, myFT2;

// Obtain the first time value
myFT1 = CFileTime::GetCurrentTime();

// Pause for a moment...
Sleep(1000);

// Obtain the second time value
myFT2 = CFileTime::GetCurrentTime();

// Perform the comparison
if (myFT1 < myFT2)
   _tprintf_s(_T("Time is going in the correct direction.\n"));
else
   _tprintf_s(_T("Oh dear. Time is going backwards.\n"));

`CFileTime::operator <>=`

Este operador compara dos objetos CFileTime para determinar si son iguales o cuál es el menor.

bool operator<=(CFileTime ft) const throw();

Parámetros

ft
Objeto CFileTime que se va a comparar.

Valor devuelto

Devuelve TRUE si el primer objeto es menos (antes en tiempo) o igual que el segundo; de lo contrario,FALSE.

`CFileTime::operator =`

Operador de asignación.

CFileTime& operator=(const FILETIME& ft) throw();

Parámetros

ft
Objeto CFileTime que contiene la nueva fecha y hora.

Valor devuelto

Devuelve el objeto CFileTime actualizado.

`CFileTime::operator -=`

Este operador se usa para restar en un objeto CFileTimeSpan y asignar el resultado al objeto actual.

CFileTime& operator-=(CFileTimeSpan span) throw();

Parámetros

span
Objeto CFileTimeSpan que contiene el tiempo relativo que se va a restar.

Valor devuelto

Devuelve el objeto CFileTime actualizado.

`CFileTime::operator ==`

Este operador compara dos objetos CFileTime para determinar si son iguales.

bool operator==(CFileTime ft) const throw();

Parámetros

ft
El objeto CFileTime que se va a comparar.

Valor devuelto

Devuelve TRUE si los dos objetos son iguales; en caso contrario, devuelve FALSE.

`CFileTime::operator >`

Este operador compara dos objetos CFileTime para determinar el mayor.

bool operator>(CFileTime ft) const throw();

Parámetros

ft
Objeto CFileTime que se va a comparar.

Valor devuelto

Devuelve TRUE si el primer objeto es más (después en tiempo) que el segundo; de lo contrario, FALSE.

`CFileTime::operator >=`

Este operador compara dos objetos CFileTime para determinar si son iguales o cuál es el mayor.

bool operator>=(CFileTime ft) const throw();

Parámetros

ft
Objeto CFileTime que se va a comparar.

Valor devuelto

Devuelve TRUE si el primer objeto es más (después en tiempo) o igual que el segundo; de lo contrario, FALSE.

`CFileTime::Second`

Miembro de datos estático que almacena el número de intervalos de 100 nanosegundos que componen un día.

static const ULONGLONG Second = Millisecond* 1000;

Ejemplo

Vea el ejemplo de CFileTime::Millisecond.

`CFileTime::SetTime`

Llame a este método para establecer la fecha y la hora almacenadas por el objeto CFileTime.

void SetTime(ULONGLONG nTime) throw();

Parámetros

nTime
Valor de 64 bits que representa la fecha y hora, en formato local u hora universal coordinada (UTC).

`CFileTime::UTCToLocal`

Llame a este método para convertir la hora en función de la hora universal coordinada (UTC) a la hora del archivo local.

CFileTime UTCToLocal() const throw();

Valor devuelto

Devuelve un objeto CFileTime que contiene la hora en formato de hora de archivo local.

Ejemplo

// Convert a UTC time to local file time format
CFileTime myUTC_FT, myL_FT;
// Get system time (in UTC format)
myUTC_FT = CFileTime::GetCurrentTime();
// Convert to local file time
myL_FT = myUTC_FT.UTCToLocal();

`CFileTime::Week`

Miembro de datos estático que almacena el número de intervalos de 100 nanosegundos que componen una semana.

static const ULONGLONG Week = Day* 7;

Ejemplo

Vea el ejemplo de CFileTime::Millisecond.

Consulte también

FILETIME
Clase CFileTimeSpan
Gráfico de jerarquías
Clases compartidas de ATL y MFC

Compartir a través de

Clase CFileTime

Sintaxis

Miembros

Constructores públicos

Métodos públicos

Operadores públicos

Constantes públicas

Comentarios

Jerarquía de herencia

Requisitos

CFileTime::CFileTime

Parámetros

Comentarios

CFileTime::Day

Ejemplo

CFileTime::GetCurrentTime

Valor devuelto

Ejemplo

CFileTime::GetTime

Valor devuelto

CFileTime::Hour

Ejemplo

CFileTime::LocalToUTC

Valor devuelto

Ejemplo

CFileTime::Millisecond

Ejemplo

CFileTime::Minute

Ejemplo

CFileTime::operator -

Parámetros

Valor devuelto

CFileTime::operator !=

Parámetros

Valor devuelto

CFileTime::operator +

Parámetros

Valor devuelto

CFileTime::operator +=

Parámetros

Valor devuelto

CFileTime::operator <

Parámetros

Valor devuelto

Ejemplo

CFileTime::operator <>=

Parámetros

Valor devuelto

CFileTime::operator =

Parámetros

Valor devuelto

CFileTime::operator -=

Parámetros

Valor devuelto

CFileTime::operator ==

Parámetros

Valor devuelto

CFileTime::operator >

Parámetros

Valor devuelto

CFileTime::operator >=

Parámetros

Valor devuelto

CFileTime::Second

Ejemplo

CFileTime::SetTime

Parámetros

CFileTime::UTCToLocal

Valor devuelto

Ejemplo

CFileTime::Week

Ejemplo

Consulte también

Comentarios

Recursos adicionales

Clase `CFileTime`

`CFileTime::CFileTime`

`CFileTime::Day`

`CFileTime::GetCurrentTime`

`CFileTime::GetTime`

`CFileTime::Hour`

`CFileTime::LocalToUTC`

`CFileTime::Millisecond`

`CFileTime::Minute`

`CFileTime::operator -`

`CFileTime::operator !=`

`CFileTime::operator +`

`CFileTime::operator +=`

`CFileTime::operator <`

`CFileTime::operator <>=`

`CFileTime::operator =`

`CFileTime::operator -=`

`CFileTime::operator ==`

`CFileTime::operator >`

`CFileTime::operator >=`

`CFileTime::Second`

`CFileTime::SetTime`

`CFileTime::UTCToLocal`

`CFileTime::Week`