tz2.c

Go to the documentation of this file.

/*
 * Copyright (C) 1995.  Bill Brown <brown@gis.uiuc.edu> & Michael Shapiro
 *
 * This program is free software under the GPL (>=v2)
 * Read the file GPL.TXT coming with GRASS for details.
 */
#include <grass/datetime.h>
 
/*!
 * \brief
 *
 * if dt has a timezone, increment dt by minutes-dt.tz MINUTES and set dt.tz =
 * minutes Returns: 0 OK <b>datetime_check_timezone</b> (dt) if not -4 if
 * minutes invalid
 *
 *  \param dt
 *  \param minutes
 *  \return int
 */
int datetime_change_timezone(DateTime *dt, int minutes)
{ /* new timezone in minutes */
    int stat;
    int old_minutes, diff_minutes;
    DateTime incr;
 
    stat = datetime_get_timezone(dt, &old_minutes);
    if (stat != 0)
        return stat;
    if (!datetime_is_valid_timezone(minutes))
        return datetime_error(-4, "invalid datetime timezone");
 
    /* create a relative minute increment */
    datetime_set_type(&incr, DATETIME_RELATIVE, DATETIME_MINUTE,
                      DATETIME_MINUTE, 0);
 
    /* BB - needed to set SIGN here */
    diff_minutes = minutes - old_minutes;
    if (diff_minutes >= 0) {
        datetime_set_minute(&incr, diff_minutes);
    }
    else {
        datetime_invert_sign(&incr);
        datetime_set_minute(&incr, -diff_minutes);
    }
 
    return datetime_increment(dt, &incr);
}
 
/*!
 * \brief
 *
 * Return <b>datetime_change_timezone</b> (dt, 0);
 *
 *  \param dt
 *  \return int
 */
int datetime_change_to_utc(DateTime *dt)
{
    return datetime_change_timezone(dt, 0);
}
 
/*!
 * \brief
 *
 * tz = abs(tz)
 * *hour = tz/60
 * *minute = tz%60
 * Note: hour,minute are non-negative. Must look at sign of tz itself to see if
 * the tz is negative offset or not. This routine would be used to format tz for
 * output. For example if tz=-350 this would be hour=5 minute=50, but negative.
 * Output might encode this as -0550: printf ("%s%02d%02d", tz<0?"-":"",
 * hour, minute)
 *
 *  \param tz
 *  \param hours
 *  \param minutes
 *  \return void
 */
void datetime_decompose_timezone(int tz, int *hours, int *minutes)
{
    if (tz < 0)
        tz = -tz;
 
    *hours = tz / 60;
    *minutes = tz % 60;
}