Clase wxTimeSpan
La clase wxTimeSpan representa un intervalo de tiempo.
Funciones miembro
wxTimeSpan()
wxTimeSpan::wxTimeSpan()
Constructor por defecto, construye un intervalo de tiempo cero.
wxTimeSpan()
wxTimeSpan::wxTimeSpan( long hours, long min = 0, wxLongLong sec = 0, wxLongLong msec = 0 )
Construye timespan a partir de valores separados para cada componente, con la fecha establecida en 0.
Las horas no están restringidas al rango 0-24, ni tampoco los minutos, segundos o milisegundos.
Abs()
wxTimeSpan wxTimeSpan::Abs() const
Devuelve el valor absoluto del timespan: no modifica el objeto.
Add()
wxTimeSpan& wxTimeSpan::Add(const wxTimeSpan & diff)
Añade el wxTimeSpan dado a este wxTimeSpan y devuelve una referencia a sí mismo.
Add()
wxTimeSpan wxTimeSpan::Add(const wxTimeSpan & diff) const
Devuelve la suma de dos intervalos de tiempo.
Valor de retorno
Un nuevo objeto wxTimeSpan con el resultado.
Day()
static wxTimeSpan wxTimeSpan::Day()
Devuelve la duración de un día.
Days()
static wxTimeSpan wxTimeSpan::Days(long days)
Devuelve el intervalo de tiempo para el número de días dado.
Format()
Devuelve la cadena que contiene la representación formateada del intervalo de tiempo.
Se permiten los siguientes especificadores de formato después de %:
- H - Número de horas
- M - Número de minutos
- S - Número de segundos
- l - Número de milisegundos
- D - Número de días
- E - Número de semanas
- % - El carácter de porcentaje
Obsérvese que, por ejemplo, el número de horas en la descripción anterior no está bien definido: puede ser el número total de horas (por ejemplo, para un lapso de tiempo de 50 horas sería 50) o sólo la parte de horas del lapso de tiempo, que sería 2 en este caso, ya que 50 horas equivalen a 2 días y 2 horas.
wxTimeSpan resuelve esta ambigüedad de la siguiente manera: si hubiera habido, en efecto, el formato D especificado precediendo a la H, entonces se interpreta como 2. En caso contrario, es 50.
Lo mismo se aplica a todos los demás especificadores de formato: si siguen a un especificador de unidad mayor, sólo se toma la parte restante; en caso contrario, se utiliza el valor completo.
GetDays()
int wxTimeSpan::GetDays() const
Devuelve la diferencia en número de días.
GetHours()
int wxTimeSpan::GetHours() const
Devuelve la diferencia en número de horas.
GetMilliseconds()
wxLongLong wxTimeSpan::GetMilliseconds() const
Devuelve la diferencia en número de milisegundos.
GetMinutes()
int wxTimeSpan::GetMinutes() const
Devuelve la diferencia en número de minutos.
GetSeconds()
wxLongLong wxTimeSpan::GetSeconds() const
Devuelve la diferencia en número de segundos.
GetValue()
wxLongLong wxTimeSpan::GetValue() const
Devuelve la representación interna del timespan.
GetWeeks()
int wxTimeSpan::GetWeeks() const
Devuelve la diferencia en número de semanas.
Hour()
static wxTimeSpan wxTimeSpan::Hour()
Devuelve la duración de una hora.
Hours()
static wxTimeSpan wxTimeSpan::Hours(long hours)
Devuelve el intervalo de tiempo para el número de horas dado.
IsEqualTo()
bool wxTimeSpan::IsEqualTo(const wxTimeSpan & ts) const
Devuelve true si dos timespans son iguales.
IsLongerThan()
bool wxTimeSpan::IsLongerThan(const wxTimeSpan & ts) const
Compara dos intervalos de tiempo: trabaja con los valores absolutos, es decir, -2 horas es más largo que 1 hora.
IsNegative()
bool wxTimeSpan::IsNegative() const
Devuelve verdadero si el intervalo de tiempo es negativo.
IsNull()
bool wxTimeSpan::IsNull() const
Devuelve verdadero si el intervalo de tiempo está vacío.
IsPositive()
bool wxTimeSpan::IsPositive() const
Devuelve true si el timespan es positivo.
IsShorterThan()
bool wxTimeSpan::IsShorterThan(const wxTimeSpan & ts) const
Compara dos timespans: trabaja con los valores absolutos, es decir, 1 hora es más corta que -2 horas.
Además, devolverá false si los intervalos de tiempo son iguales en valor absoluto.
Millisecond()
static wxTimeSpan wxTimeSpan::Millisecond()
Devuelve la duración de un milisegundo.
Milliseconds()
static wxTimeSpan wxTimeSpan::Milliseconds(wxLongLong ms)
Devuelve el intervalo de tiempo para el número dado de milisegundos.
Minute()
static wxTimeSpan wxTimeSpan::Minute()
Devuelve la duración de un minuto.
Minutes()
static wxTimeSpan wxTimeSpan::Minutes(long min)
Devuelve el intervalo de tiempo para el número de minutos dado.
Multiply()
wxTimeSpan& wxTimeSpan::Multiply(int n)
Multiplica este intervalo de tiempo por n.
Valor de retorno
Una referencia a este objeto wxTimeSpan modificado en su lugar.
Multiply()
wxTimeSpan wxTimeSpan::Multiply(int n) const
Devuelve el producto de este lapso de tiempo por n.
Valor de retorno
Un nuevo objeto wxTimeSpan con el resultado.
Neg()
wxTimeSpan& wxTimeSpan::Neg()
Niega el valor de la duración.
Negate()
wxTimeSpan wxTimeSpan::Negate() const
Devuelve el timespan con el signo invertido.
Second()
static wxTimeSpan wxTimeSpan::Second()
Devuelve la duración de un segundo.
Seconds()
static wxTimeSpan wxTimeSpan::Seconds(wxLongLong sec)
Devuelve la duración de un segundo.
Subtract()
wxTimeSpan& wxTimeSpan::Subtract(const wxTimeSpan & diff)
Resta el wxTimeSpan dado a este wxTimeSpan y devuelve una referencia a sí mismo.
Subtract()
wxTimeSpan wxTimeSpan::Subtract(const wxTimeSpan & diff) const
Devuelve la diferencia de dos intervalos de tiempo.
Valor de retorno
Un nuevo objeto wxTimeSpan con el resultado.
Week()
static wxTimeSpan wxTimeSpan::Week()
Devuelve la duración de una semana.
Weeks()
static wxTimeSpan wxTimeSpan::Weeks(long weeks)
Devuelve la duración del número de semanas dado.
Operadores miembro
operator*=()
wxTimeSpan& wxTimeSpan::operator*=(int n)
Multiplica este intervalo de tiempo por n.
Valor de retorno
Una referencia a este objeto wxTimeSpan modificado en su lugar.
operator+=()
wxTimeSpan& wxTimeSpan::operator+=(const wxTimeSpan & diff)
Añade el wxTimeSpan dado a este wxTimeSpan y devuelve el resultado.
operator-()
wxTimeSpan& wxTimeSpan::operator-()
Niega el valor del timespan.
operator-=()
wxTimeSpan& wxTimeSpan::operator-=(const wxTimeSpan & diff)
Resta el wxTimeSpan dado a este wxTimeSpan y devuelve el resultado.