Blame glib/glib/gdate.c

Packit db3073
/* GLIB - Library of useful routines for C programming
Packit db3073
 * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
Packit db3073
 *
Packit db3073
 * This library is free software; you can redistribute it and/or
Packit db3073
 * modify it under the terms of the GNU Lesser General Public
Packit db3073
 * License as published by the Free Software Foundation; either
Packit db3073
 * version 2 of the License, or (at your option) any later version.
Packit db3073
 *
Packit db3073
 * This library is distributed in the hope that it will be useful,
Packit db3073
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit db3073
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
Packit db3073
 * Lesser General Public License for more details.
Packit db3073
 *
Packit db3073
 * You should have received a copy of the GNU Lesser General Public
Packit db3073
 * License along with this library; if not, write to the
Packit db3073
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Packit db3073
 * Boston, MA 02111-1307, USA.
Packit db3073
 */
Packit db3073
Packit db3073
/*
Packit db3073
 * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
Packit db3073
 * file for a list of people on the GLib Team.  See the ChangeLog
Packit db3073
 * files for a list of changes.  These files are distributed with
Packit db3073
 * GLib at ftp://ftp.gtk.org/pub/gtk/. 
Packit db3073
 */
Packit db3073
Packit db3073
/* 
Packit db3073
 * MT safe
Packit db3073
 */
Packit db3073
Packit db3073
#include "config.h"
Packit db3073
#include "glibconfig.h"
Packit db3073
Packit db3073
#define DEBUG_MSG(x)	/* */
Packit db3073
#ifdef G_ENABLE_DEBUG
Packit db3073
/* #define DEBUG_MSG(args)	g_message args ; */
Packit db3073
#endif
Packit db3073
Packit db3073
#include <time.h>
Packit db3073
#include <string.h>
Packit db3073
#include <stdlib.h>
Packit db3073
#include <locale.h>
Packit db3073
Packit db3073
#ifdef G_OS_WIN32
Packit db3073
#include <windows.h>
Packit db3073
#endif
Packit db3073
Packit db3073
#include "gdate.h"
Packit db3073
Packit db3073
#include "gconvert.h"
Packit db3073
#include "gmem.h"
Packit db3073
#include "gstrfuncs.h"
Packit db3073
#include "gtestutils.h"
Packit db3073
#include "gthread.h"
Packit db3073
#include "gunicode.h"
Packit db3073
Packit db3073
#ifdef G_OS_WIN32
Packit db3073
#include "garray.h"
Packit db3073
#endif
Packit db3073
Packit db3073
/**
Packit db3073
 * SECTION:date
Packit db3073
 * @title: Date and Time Functions
Packit db3073
 * @short_description: calendrical calculations and miscellaneous time stuff
Packit db3073
 *
Packit db3073
 * The #GDate data structure represents a day between January 1, Year 1,
Packit db3073
 * and sometime a few thousand years in the future (right now it will go
Packit db3073
 * to the year 65535 or so, but g_date_set_parse() only parses up to the
Packit db3073
 * year 8000 or so - just count on "a few thousand"). #GDate is meant to
Packit db3073
 * represent everyday dates, not astronomical dates or historical dates
Packit db3073
 * or ISO timestamps or the like. It extrapolates the current Gregorian
Packit db3073
 * calendar forward and backward in time; there is no attempt to change
Packit db3073
 * the calendar to match time periods or locations. #GDate does not store
Packit db3073
 * time information; it represents a <emphasis>day</emphasis>.
Packit db3073
 *
Packit db3073
 * The #GDate implementation has several nice features; it is only a
Packit db3073
 * 64-bit struct, so storing large numbers of dates is very efficient. It
Packit db3073
 * can keep both a Julian and day-month-year representation of the date,
Packit db3073
 * since some calculations are much easier with one representation or the
Packit db3073
 * other. A Julian representation is simply a count of days since some
Packit db3073
 * fixed day in the past; for #GDate the fixed day is January 1, 1 AD.
Packit db3073
 * ("Julian" dates in the #GDate API aren't really Julian dates in the
Packit db3073
 * technical sense; technically, Julian dates count from the start of the
Packit db3073
 * Julian period, Jan 1, 4713 BC).
Packit db3073
 *
Packit db3073
 * #GDate is simple to use. First you need a "blank" date; you can get a
Packit db3073
 * dynamically allocated date from g_date_new(), or you can declare an
Packit db3073
 * automatic variable or array and initialize it to a sane state by
Packit db3073
 * calling g_date_clear(). A cleared date is sane; it's safe to call
Packit db3073
 * g_date_set_dmy() and the other mutator functions to initialize the
Packit db3073
 * value of a cleared date. However, a cleared date is initially
Packit db3073
 * <emphasis>invalid</emphasis>, meaning that it doesn't represent a day
Packit db3073
 * that exists. It is undefined to call any of the date calculation
Packit db3073
 * routines on an invalid date. If you obtain a date from a user or other
Packit db3073
 * unpredictable source, you should check its validity with the
Packit db3073
 * g_date_valid() predicate. g_date_valid() is also used to check for
Packit db3073
 * errors with g_date_set_parse() and other functions that can
Packit db3073
 * fail. Dates can be invalidated by calling g_date_clear() again.
Packit db3073
 *
Packit db3073
 * <emphasis>It is very important to use the API to access the #GDate
Packit db3073
 * struct.</emphasis> Often only the day-month-year or only the Julian
Packit db3073
 * representation is valid. Sometimes neither is valid. Use the API.
Packit db3073
 *
Packit db3073
 * GLib also features #GDateTime which represents a precise time.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * G_USEC_PER_SEC:
Packit db3073
 *
Packit db3073
 * Number of microseconds in one second (1 million).
Packit db3073
 * This macro is provided for code readability.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * GTimeVal:
Packit db3073
 * @tv_sec: seconds
Packit db3073
 * @tv_usec: microseconds
Packit db3073
 *
Packit db3073
 * Represents a precise time, with seconds and microseconds.
Packit db3073
 * Similar to the <structname>struct timeval</structname> returned by
Packit db3073
 * the gettimeofday() UNIX system call.
Packit db3073
 *
Packit db3073
 * GLib is attempting to unify around the use of 64bit integers to
Packit db3073
 * represent microsecond-precision time. As such, this type will be
Packit db3073
 * removed from a future version of GLib.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * GDate:
Packit db3073
 * @julian_days: the Julian representation of the date
Packit db3073
 * @julian: this bit is set if @julian_days is valid
Packit db3073
 * @dmy: this is set if @day, @month and @year are valid
Packit db3073
 * @day: the day of the day-month-year representation of the date,
Packit db3073
 *     as a number between 1 and 31
Packit db3073
 * @month: the day of the day-month-year representation of the date,
Packit db3073
 *     as a number between 1 and 12
Packit db3073
 * @year: the day of the day-month-year representation of the date
Packit db3073
 *
Packit db3073
 * Represents a day between January 1, Year 1 and a few thousand years in
Packit db3073
 * the future. None of its members should be accessed directly. If the
Packit db3073
 * <structname>GDate</structname> is obtained from g_date_new(), it will
Packit db3073
 * be safe to mutate but invalid and thus not safe for calendrical
Packit db3073
 * computations. If it's declared on the stack, it will contain garbage
Packit db3073
 * so must be initialized with g_date_clear(). g_date_clear() makes the
Packit db3073
 * date invalid but sane. An invalid date doesn't represent a day, it's
Packit db3073
 * "empty." A date becomes valid after you set it to a Julian day or you
Packit db3073
 * set a day, month, and year.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * GTime:
Packit db3073
 *
Packit db3073
 * Simply a replacement for <type>time_t</type>. It has been deprecated
Packit db3073
 * since it is <emphasis>not</emphasis> equivalent to <type>time_t</type>
Packit db3073
 * on 64-bit platforms with a 64-bit <type>time_t</type>.
Packit db3073
 * Unrelated to #GTimer.
Packit db3073
 *
Packit db3073
 * Note that <type>GTime</type> is defined to always be a 32bit integer,
Packit db3073
 * unlike <type>time_t</type> which may be 64bit on some systems.
Packit db3073
 * Therefore, <type>GTime</type> will overflow in the year 2038, and
Packit db3073
 * you cannot use the address of a <type>GTime</type> variable as argument
Packit db3073
 * to the UNIX time() function. Instead, do the following:
Packit db3073
 * |[
Packit db3073
 * time_t ttime;
Packit db3073
 * GTime gtime;
Packit db3073
 *
Packit db3073
 * time (&ttime);
Packit db3073
 * gtime = (GTime)ttime;
Packit db3073
 * ]|
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * GDateDMY:
Packit db3073
 * @G_DATE_DAY: a day
Packit db3073
 * @G_DATE_MONTH: a month
Packit db3073
 * @G_DATE_YEAR: a year
Packit db3073
 *
Packit db3073
 * This enumeration isn't used in the API, but may be useful if you need
Packit db3073
 * to mark a number as a day, month, or year.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * GDateDay:
Packit db3073
 *
Packit db3073
 * Integer representing a day of the month; between 1 and
Packit db3073
 * 31. #G_DATE_BAD_DAY represents an invalid day of the month.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * GDateMonth:
Packit db3073
 * @G_DATE_BAD_MONTH: invalid value
Packit db3073
 * @G_DATE_JANUARY: January
Packit db3073
 * @G_DATE_FEBRUARY: February
Packit db3073
 * @G_DATE_MARCH: March
Packit db3073
 * @G_DATE_APRIL: April
Packit db3073
 * @G_DATE_MAY: May
Packit db3073
 * @G_DATE_JUNE: June
Packit db3073
 * @G_DATE_JULY: July
Packit db3073
 * @G_DATE_AUGUST: August
Packit db3073
 * @G_DATE_SEPTEMBER: September
Packit db3073
 * @G_DATE_OCTOBER: October
Packit db3073
 * @G_DATE_NOVEMBER: November
Packit db3073
 * @G_DATE_DECEMBER: December
Packit db3073
 *
Packit db3073
 * Enumeration representing a month; values are #G_DATE_JANUARY,
Packit db3073
 * #G_DATE_FEBRUARY, etc. #G_DATE_BAD_MONTH is the invalid value.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * GDateYear:
Packit db3073
 *
Packit db3073
 * Integer representing a year; #G_DATE_BAD_YEAR is the invalid
Packit db3073
 * value. The year must be 1 or higher; negative (BC) years are not
Packit db3073
 * allowed. The year is represented with four digits.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * GDateWeekday:
Packit db3073
 * @G_DATE_BAD_WEEKDAY: invalid value
Packit db3073
 * @G_DATE_MONDAY: Monday
Packit db3073
 * @G_DATE_TUESDAY: Tuesday
Packit db3073
 * @G_DATE_WEDNESDAY: Wednesday
Packit db3073
 * @G_DATE_THURSDAY: Thursday
Packit db3073
 * @G_DATE_FRIDAY: Friday
Packit db3073
 * @G_DATE_SATURDAY: Saturday
Packit db3073
 * @G_DATE_SUNDAY: Sunday
Packit db3073
 *
Packit db3073
 * Enumeration representing a day of the week; #G_DATE_MONDAY,
Packit db3073
 * #G_DATE_TUESDAY, etc. #G_DATE_BAD_WEEKDAY is an invalid weekday.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * G_DATE_BAD_DAY:
Packit db3073
 *
Packit db3073
 * Represents an invalid #GDateDay.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * G_DATE_BAD_JULIAN:
Packit db3073
 *
Packit db3073
 * Represents an invalid Julian day number.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * G_DATE_BAD_YEAR:
Packit db3073
 *
Packit db3073
 * Represents an invalid year.
Packit db3073
 */
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_new:
Packit db3073
 *
Packit db3073
 * Allocates a #GDate and initializes
Packit db3073
 * it to a sane state. The new date will
Packit db3073
 * be cleared (as if you'd called g_date_clear()) but invalid (it won't
Packit db3073
 * represent an existing day). Free the return value with g_date_free().
Packit db3073
 *
Packit db3073
 * Returns: a newly-allocated #GDate
Packit db3073
 */
Packit db3073
GDate*
Packit db3073
g_date_new (void)
Packit db3073
{
Packit db3073
  GDate *d = g_new0 (GDate, 1); /* happily, 0 is the invalid flag for everything. */
Packit db3073
  
Packit db3073
  return d;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_new_dmy:
Packit db3073
 * @day: day of the month
Packit db3073
 * @month: month of the year
Packit db3073
 * @year: year
Packit db3073
 *
Packit db3073
 * Like g_date_new(), but also sets the value of the date. Assuming the
Packit db3073
 * day-month-year triplet you pass in represents an existing day, the
Packit db3073
 * returned date will be valid.
Packit db3073
 *
Packit db3073
 * Returns: a newly-allocated #GDate initialized with @day, @month, and @year
Packit db3073
 */
Packit db3073
GDate*
Packit db3073
g_date_new_dmy (GDateDay   day, 
Packit db3073
                GDateMonth m, 
Packit db3073
                GDateYear  y)
Packit db3073
{
Packit db3073
  GDate *d;
Packit db3073
  g_return_val_if_fail (g_date_valid_dmy (day, m, y), NULL);
Packit db3073
  
Packit db3073
  d = g_new (GDate, 1);
Packit db3073
  
Packit db3073
  d->julian = FALSE;
Packit db3073
  d->dmy    = TRUE;
Packit db3073
  
Packit db3073
  d->month = m;
Packit db3073
  d->day   = day;
Packit db3073
  d->year  = y;
Packit db3073
  
Packit db3073
  g_assert (g_date_valid (d));
Packit db3073
  
Packit db3073
  return d;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_new_julian:
Packit db3073
 * @julian_day: days since January 1, Year 1
Packit db3073
 *
Packit db3073
 * Like g_date_new(), but also sets the value of the date. Assuming the
Packit db3073
 * Julian day number you pass in is valid (greater than 0, less than an
Packit db3073
 * unreasonably large number), the returned date will be valid.
Packit db3073
 *
Packit db3073
 * Returns: a newly-allocated #GDate initialized with @julian_day
Packit db3073
 */
Packit db3073
GDate*
Packit db3073
g_date_new_julian (guint32 julian_day)
Packit db3073
{
Packit db3073
  GDate *d;
Packit db3073
  g_return_val_if_fail (g_date_valid_julian (julian_day), NULL);
Packit db3073
  
Packit db3073
  d = g_new (GDate, 1);
Packit db3073
  
Packit db3073
  d->julian = TRUE;
Packit db3073
  d->dmy    = FALSE;
Packit db3073
  
Packit db3073
  d->julian_days = julian_day;
Packit db3073
  
Packit db3073
  g_assert (g_date_valid (d));
Packit db3073
  
Packit db3073
  return d;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_free:
Packit db3073
 * @date: a #GDate to free
Packit db3073
 *
Packit db3073
 * Frees a #GDate returned from g_date_new().
Packit db3073
 */
Packit db3073
void
Packit db3073
g_date_free (GDate *date)
Packit db3073
{
Packit db3073
  g_return_if_fail (date != NULL);
Packit db3073
  
Packit db3073
  g_free (date);
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_valid:
Packit db3073
 * @date: a #GDate to check
Packit db3073
 *
Packit db3073
 * Returns %TRUE if the #GDate represents an existing day. The date must not
Packit db3073
 * contain garbage; it should have been initialized with g_date_clear()
Packit db3073
 * if it wasn't allocated by one of the g_date_new() variants.
Packit db3073
 *
Packit db3073
 * Returns: Whether the date is valid
Packit db3073
 */
Packit db3073
gboolean     
Packit db3073
g_date_valid (const GDate *d)
Packit db3073
{
Packit db3073
  g_return_val_if_fail (d != NULL, FALSE);
Packit db3073
  
Packit db3073
  return (d->julian || d->dmy);
Packit db3073
}
Packit db3073
Packit db3073
static const guint8 days_in_months[2][13] = 
Packit db3073
{  /* error, jan feb mar apr may jun jul aug sep oct nov dec */
Packit db3073
  {  0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 }, 
Packit db3073
  {  0, 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 } /* leap year */
Packit db3073
};
Packit db3073
Packit db3073
static const guint16 days_in_year[2][14] = 
Packit db3073
{  /* 0, jan feb mar apr may  jun  jul  aug  sep  oct  nov  dec */
Packit db3073
  {  0, 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365 }, 
Packit db3073
  {  0, 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366 }
Packit db3073
};
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_valid_month:
Packit db3073
 * @month: month
Packit db3073
 *
Packit db3073
 * Returns %TRUE if the month value is valid. The 12 #GDateMonth
Packit db3073
 * enumeration values are the only valid months.
Packit db3073
 *
Packit db3073
 * Returns: %TRUE if the month is valid
Packit db3073
 */
Packit db3073
gboolean     
Packit db3073
g_date_valid_month (GDateMonth m)
Packit db3073
{ 
Packit db3073
  return ( (m > G_DATE_BAD_MONTH) && (m < 13) );
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_valid_year:
Packit db3073
 * @year: year
Packit db3073
 *
Packit db3073
 * Returns %TRUE if the year is valid. Any year greater than 0 is valid,
Packit db3073
 * though there is a 16-bit limit to what #GDate will understand.
Packit db3073
 *
Packit db3073
 * Returns: %TRUE if the year is valid
Packit db3073
 */
Packit db3073
gboolean     
Packit db3073
g_date_valid_year (GDateYear y)
Packit db3073
{
Packit db3073
  return ( y > G_DATE_BAD_YEAR );
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_valid_day:
Packit db3073
 * @day: day to check
Packit db3073
 *
Packit db3073
 * Returns %TRUE if the day of the month is valid (a day is valid if it's
Packit db3073
 * between 1 and 31 inclusive).
Packit db3073
 *
Packit db3073
 * Returns: %TRUE if the day is valid
Packit db3073
 */
Packit db3073
Packit db3073
gboolean     
Packit db3073
g_date_valid_day (GDateDay d)
Packit db3073
{
Packit db3073
  return ( (d > G_DATE_BAD_DAY) && (d < 32) );
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_valid_weekday:
Packit db3073
 * @weekday: weekday
Packit db3073
 *
Packit db3073
 * Returns %TRUE if the weekday is valid. The seven #GDateWeekday enumeration
Packit db3073
 * values are the only valid weekdays.
Packit db3073
 *
Packit db3073
 * Returns: %TRUE if the weekday is valid
Packit db3073
 */
Packit db3073
gboolean     
Packit db3073
g_date_valid_weekday (GDateWeekday w)
Packit db3073
{
Packit db3073
  return ( (w > G_DATE_BAD_WEEKDAY) && (w < 8) );
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_valid_julian:
Packit db3073
 * @julian_date: Julian day to check
Packit db3073
 *
Packit db3073
 * Returns %TRUE if the Julian day is valid. Anything greater than zero
Packit db3073
 * is basically a valid Julian, though there is a 32-bit limit.
Packit db3073
 *
Packit db3073
 * Returns: %TRUE if the Julian day is valid
Packit db3073
 */
Packit db3073
gboolean     
Packit db3073
g_date_valid_julian (guint32 j)
Packit db3073
{
Packit db3073
  return (j > G_DATE_BAD_JULIAN);
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_valid_dmy:
Packit db3073
 * @day: day
Packit db3073
 * @month: month
Packit db3073
 * @year: year
Packit db3073
 *
Packit db3073
 * Returns %TRUE if the day-month-year triplet forms a valid, existing day
Packit db3073
 * in the range of days #GDate understands (Year 1 or later, no more than
Packit db3073
 * a few thousand years in the future).
Packit db3073
 *
Packit db3073
 * Returns: %TRUE if the date is a valid one
Packit db3073
 */
Packit db3073
gboolean     
Packit db3073
g_date_valid_dmy (GDateDay   d, 
Packit db3073
                  GDateMonth m, 
Packit db3073
		  GDateYear  y)
Packit db3073
{
Packit db3073
  return ( (m > G_DATE_BAD_MONTH) &&
Packit db3073
           (m < 13)               && 
Packit db3073
           (d > G_DATE_BAD_DAY)   && 
Packit db3073
           (y > G_DATE_BAD_YEAR)  &&   /* must check before using g_date_is_leap_year */
Packit db3073
           (d <=  (g_date_is_leap_year (y) ? 
Packit db3073
		   days_in_months[1][m] : days_in_months[0][m])) );
Packit db3073
}
Packit db3073
Packit db3073
Packit db3073
/* "Julian days" just means an absolute number of days, where Day 1 ==
Packit db3073
 *   Jan 1, Year 1
Packit db3073
 */
Packit db3073
static void
Packit db3073
g_date_update_julian (const GDate *const_d)
Packit db3073
{
Packit db3073
  GDate *d = (GDate *) const_d;
Packit db3073
  GDateYear year;
Packit db3073
  gint idx;
Packit db3073
  
Packit db3073
  g_return_if_fail (d != NULL);
Packit db3073
  g_return_if_fail (d->dmy);
Packit db3073
  g_return_if_fail (!d->julian);
Packit db3073
  g_return_if_fail (g_date_valid_dmy (d->day, d->month, d->year));
Packit db3073
  
Packit db3073
  /* What we actually do is: multiply years * 365 days in the year,
Packit db3073
   * add the number of years divided by 4, subtract the number of
Packit db3073
   * years divided by 100 and add the number of years divided by 400,
Packit db3073
   * which accounts for leap year stuff. Code from Steffen Beyer's
Packit db3073
   * DateCalc. 
Packit db3073
   */
Packit db3073
  
Packit db3073
  year = d->year - 1; /* we know d->year > 0 since it's valid */
Packit db3073
  
Packit db3073
  d->julian_days = year * 365U;
Packit db3073
  d->julian_days += (year >>= 2); /* divide by 4 and add */
Packit db3073
  d->julian_days -= (year /= 25); /* divides original # years by 100 */
Packit db3073
  d->julian_days += year >> 2;    /* divides by 4, which divides original by 400 */
Packit db3073
  
Packit db3073
  idx = g_date_is_leap_year (d->year) ? 1 : 0;
Packit db3073
  
Packit db3073
  d->julian_days += days_in_year[idx][d->month] + d->day;
Packit db3073
  
Packit db3073
  g_return_if_fail (g_date_valid_julian (d->julian_days));
Packit db3073
  
Packit db3073
  d->julian = TRUE;
Packit db3073
}
Packit db3073
Packit db3073
static void 
Packit db3073
g_date_update_dmy (const GDate *const_d)
Packit db3073
{
Packit db3073
  GDate *d = (GDate *) const_d;
Packit db3073
  GDateYear y;
Packit db3073
  GDateMonth m;
Packit db3073
  GDateDay day;
Packit db3073
  
Packit db3073
  guint32 A, B, C, D, E, M;
Packit db3073
  
Packit db3073
  g_return_if_fail (d != NULL);
Packit db3073
  g_return_if_fail (d->julian);
Packit db3073
  g_return_if_fail (!d->dmy);
Packit db3073
  g_return_if_fail (g_date_valid_julian (d->julian_days));
Packit db3073
  
Packit db3073
  /* Formula taken from the Calendar FAQ; the formula was for the
Packit db3073
   *  Julian Period which starts on 1 January 4713 BC, so we add
Packit db3073
   *  1,721,425 to the number of days before doing the formula.
Packit db3073
   *
Packit db3073
   * I'm sure this can be simplified for our 1 January 1 AD period
Packit db3073
   * start, but I can't figure out how to unpack the formula.  
Packit db3073
   */
Packit db3073
  
Packit db3073
  A = d->julian_days + 1721425 + 32045;
Packit db3073
  B = ( 4 *(A + 36524) )/ 146097 - 1;
Packit db3073
  C = A - (146097 * B)/4;
Packit db3073
  D = ( 4 * (C + 365) ) / 1461 - 1;
Packit db3073
  E = C - ((1461*D) / 4);
Packit db3073
  M = (5 * (E - 1) + 2)/153;
Packit db3073
  
Packit db3073
  m = M + 3 - (12*(M/10));
Packit db3073
  day = E - (153*M + 2)/5;
Packit db3073
  y = 100 * B + D - 4800 + (M/10);
Packit db3073
  
Packit db3073
#ifdef G_ENABLE_DEBUG
Packit db3073
  if (!g_date_valid_dmy (day, m, y)) 
Packit db3073
    g_warning ("\nOOPS julian: %u  computed dmy: %u %u %u\n", 
Packit db3073
	       d->julian_days, day, m, y);
Packit db3073
#endif
Packit db3073
  
Packit db3073
  d->month = m;
Packit db3073
  d->day   = day;
Packit db3073
  d->year  = y;
Packit db3073
  
Packit db3073
  d->dmy = TRUE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_weekday:
Packit db3073
 * @date: a #GDate
Packit db3073
 *
Packit db3073
 * Returns the day of the week for a #GDate. The date must be valid.
Packit db3073
 *
Packit db3073
 * Returns: day of the week as a #GDateWeekday.
Packit db3073
 */
Packit db3073
GDateWeekday 
Packit db3073
g_date_get_weekday (const GDate *d)
Packit db3073
{
Packit db3073
  g_return_val_if_fail (g_date_valid (d), G_DATE_BAD_WEEKDAY);
Packit db3073
  
Packit db3073
  if (!d->julian) 
Packit db3073
    g_date_update_julian (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->julian, G_DATE_BAD_WEEKDAY);
Packit db3073
  
Packit db3073
  return ((d->julian_days - 1) % 7) + 1;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_month:
Packit db3073
 * @date: a #GDate to get the month from
Packit db3073
 *
Packit db3073
 * Returns the month of the year. The date must be valid.
Packit db3073
 *
Packit db3073
 * Returns: month of the year as a #GDateMonth
Packit db3073
 */
Packit db3073
GDateMonth   
Packit db3073
g_date_get_month (const GDate *d)
Packit db3073
{
Packit db3073
  g_return_val_if_fail (g_date_valid (d), G_DATE_BAD_MONTH);
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->dmy, G_DATE_BAD_MONTH);
Packit db3073
  
Packit db3073
  return d->month;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_year:
Packit db3073
 * @date: a #GDate
Packit db3073
 *
Packit db3073
 * Returns the year of a #GDate. The date must be valid.
Packit db3073
 *
Packit db3073
 * Returns: year in which the date falls
Packit db3073
 */
Packit db3073
GDateYear    
Packit db3073
g_date_get_year (const GDate *d)
Packit db3073
{
Packit db3073
  g_return_val_if_fail (g_date_valid (d), G_DATE_BAD_YEAR);
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->dmy, G_DATE_BAD_YEAR);  
Packit db3073
  
Packit db3073
  return d->year;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_day:
Packit db3073
 * @date: a #GDate to extract the day of the month from
Packit db3073
 *
Packit db3073
 * Returns the day of the month. The date must be valid.
Packit db3073
 *
Packit db3073
 * Returns: day of the month
Packit db3073
 */
Packit db3073
GDateDay     
Packit db3073
g_date_get_day (const GDate *d)
Packit db3073
{
Packit db3073
  g_return_val_if_fail (g_date_valid (d), G_DATE_BAD_DAY);
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->dmy, G_DATE_BAD_DAY);  
Packit db3073
  
Packit db3073
  return d->day;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_julian:
Packit db3073
 * @date: a #GDate to extract the Julian day from
Packit db3073
 *
Packit db3073
 * Returns the Julian day or "serial number" of the #GDate. The
Packit db3073
 * Julian day is simply the number of days since January 1, Year 1; i.e.,
Packit db3073
 * January 1, Year 1 is Julian day 1; January 2, Year 1 is Julian day 2,
Packit db3073
 * etc. The date must be valid.
Packit db3073
 *
Packit db3073
 * Returns: Julian day
Packit db3073
 */
Packit db3073
guint32      
Packit db3073
g_date_get_julian (const GDate *d)
Packit db3073
{
Packit db3073
  g_return_val_if_fail (g_date_valid (d), G_DATE_BAD_JULIAN);
Packit db3073
  
Packit db3073
  if (!d->julian) 
Packit db3073
    g_date_update_julian (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->julian, G_DATE_BAD_JULIAN);  
Packit db3073
  
Packit db3073
  return d->julian_days;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_day_of_year:
Packit db3073
 * @date: a #GDate to extract day of year from
Packit db3073
 *
Packit db3073
 * Returns the day of the year, where Jan 1 is the first day of the
Packit db3073
 * year. The date must be valid.
Packit db3073
 *
Packit db3073
 * Returns: day of the year
Packit db3073
 */
Packit db3073
guint        
Packit db3073
g_date_get_day_of_year (const GDate *d)
Packit db3073
{
Packit db3073
  gint idx;
Packit db3073
  
Packit db3073
  g_return_val_if_fail (g_date_valid (d), 0);
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->dmy, 0);  
Packit db3073
  
Packit db3073
  idx = g_date_is_leap_year (d->year) ? 1 : 0;
Packit db3073
  
Packit db3073
  return (days_in_year[idx][d->month] + d->day);
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_monday_week_of_year:
Packit db3073
 * @date: a #GDate
Packit db3073
 *
Packit db3073
 * Returns the week of the year, where weeks are understood to start on
Packit db3073
 * Monday. If the date is before the first Monday of the year, return
Packit db3073
 * 0. The date must be valid.
Packit db3073
 *
Packit db3073
 * Returns: week of the year
Packit db3073
 */
Packit db3073
guint        
Packit db3073
g_date_get_monday_week_of_year (const GDate *d)
Packit db3073
{
Packit db3073
  GDateWeekday wd;
Packit db3073
  guint day;
Packit db3073
  GDate first;
Packit db3073
  
Packit db3073
  g_return_val_if_fail (g_date_valid (d), 0);
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->dmy, 0);  
Packit db3073
  
Packit db3073
  g_date_clear (&first, 1);
Packit db3073
  
Packit db3073
  g_date_set_dmy (&first, 1, 1, d->year);
Packit db3073
  
Packit db3073
  wd = g_date_get_weekday (&first) - 1; /* make Monday day 0 */
Packit db3073
  day = g_date_get_day_of_year (d) - 1;
Packit db3073
  
Packit db3073
  return ((day + wd)/7U + (wd == 0 ? 1 : 0));
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_sunday_week_of_year:
Packit db3073
 * @date: a #GDate
Packit db3073
 *
Packit db3073
 * Returns the week of the year during which this date falls, if weeks
Packit db3073
 * are understood to being on Sunday. The date must be valid. Can return
Packit db3073
 * 0 if the day is before the first Sunday of the year.
Packit db3073
 *
Packit db3073
 * Returns: week number
Packit db3073
 */
Packit db3073
guint        
Packit db3073
g_date_get_sunday_week_of_year (const GDate *d)
Packit db3073
{
Packit db3073
  GDateWeekday wd;
Packit db3073
  guint day;
Packit db3073
  GDate first;
Packit db3073
  
Packit db3073
  g_return_val_if_fail (g_date_valid (d), 0);
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->dmy, 0);  
Packit db3073
  
Packit db3073
  g_date_clear (&first, 1);
Packit db3073
  
Packit db3073
  g_date_set_dmy (&first, 1, 1, d->year);
Packit db3073
  
Packit db3073
  wd = g_date_get_weekday (&first);
Packit db3073
  if (wd == 7) wd = 0; /* make Sunday day 0 */
Packit db3073
  day = g_date_get_day_of_year (d) - 1;
Packit db3073
  
Packit db3073
  return ((day + wd)/7U + (wd == 0 ? 1 : 0));
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_iso8601_week_of_year:
Packit db3073
 * @date: a valid #GDate
Packit db3073
 *
Packit db3073
 * Returns the week of the year, where weeks are interpreted according
Packit db3073
 * to ISO 8601. 
Packit db3073
 * 
Packit db3073
 * Returns: ISO 8601 week number of the year.
Packit db3073
 *
Packit db3073
 * Since: 2.6
Packit db3073
 **/
Packit db3073
guint
Packit db3073
g_date_get_iso8601_week_of_year (const GDate *d)
Packit db3073
{
Packit db3073
  guint j, d4, L, d1, w;
Packit db3073
Packit db3073
  g_return_val_if_fail (g_date_valid (d), 0);
Packit db3073
  
Packit db3073
  if (!d->julian)
Packit db3073
    g_date_update_julian (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->julian, 0);
Packit db3073
Packit db3073
  /* Formula taken from the Calendar FAQ; the formula was for the
Packit db3073
   * Julian Period which starts on 1 January 4713 BC, so we add
Packit db3073
   * 1,721,425 to the number of days before doing the formula. 
Packit db3073
   */
Packit db3073
  j  = d->julian_days + 1721425;
Packit db3073
  d4 = (j + 31741 - (j % 7)) % 146097 % 36524 % 1461;
Packit db3073
  L  = d4 / 1460;
Packit db3073
  d1 = ((d4 - L) % 365) + L;
Packit db3073
  w  = d1 / 7 + 1;
Packit db3073
Packit db3073
  return w;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_days_between:
Packit db3073
 * @date1: the first date
Packit db3073
 * @date2: the second date
Packit db3073
 *
Packit db3073
 * Computes the number of days between two dates.
Packit db3073
 * If @date2 is prior to @date1, the returned value is negative.
Packit db3073
 * Both dates must be valid.
Packit db3073
 *
Packit db3073
 * Returns: the number of days between @date1 and @date2
Packit db3073
 */
Packit db3073
gint
Packit db3073
g_date_days_between (const GDate *d1,
Packit db3073
		     const GDate *d2)
Packit db3073
{
Packit db3073
  g_return_val_if_fail (g_date_valid (d1), 0);
Packit db3073
  g_return_val_if_fail (g_date_valid (d2), 0);
Packit db3073
Packit db3073
  return (gint)g_date_get_julian (d2) - (gint)g_date_get_julian (d1);
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_clear:
Packit db3073
 * @date: pointer to one or more dates to clear
Packit db3073
 * @n_dates: number of dates to clear
Packit db3073
 *
Packit db3073
 * Initializes one or more #GDate structs to a sane but invalid
Packit db3073
 * state. The cleared dates will not represent an existing date, but will
Packit db3073
 * not contain garbage. Useful to init a date declared on the stack.
Packit db3073
 * Validity can be tested with g_date_valid().
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_clear (GDate *d, guint ndates)
Packit db3073
{
Packit db3073
  g_return_if_fail (d != NULL);
Packit db3073
  g_return_if_fail (ndates != 0);
Packit db3073
  
Packit db3073
  memset (d, 0x0, ndates*sizeof (GDate)); 
Packit db3073
}
Packit db3073
Packit db3073
G_LOCK_DEFINE_STATIC (g_date_global);
Packit db3073
Packit db3073
/* These are for the parser, output to the user should use *
Packit db3073
 * g_date_strftime () - this creates more never-freed memory to annoy
Packit db3073
 * all those memory debugger users. :-) 
Packit db3073
 */
Packit db3073
Packit db3073
static gchar *long_month_names[13] = 
Packit db3073
{ 
Packit db3073
  NULL,
Packit db3073
};
Packit db3073
Packit db3073
static gchar *short_month_names[13] = 
Packit db3073
{
Packit db3073
  NULL, 
Packit db3073
};
Packit db3073
Packit db3073
/* This tells us if we need to update the parse info */
Packit db3073
static gchar *current_locale = NULL;
Packit db3073
Packit db3073
/* order of these in the current locale */
Packit db3073
static GDateDMY dmy_order[3] = 
Packit db3073
{
Packit db3073
   G_DATE_DAY, G_DATE_MONTH, G_DATE_YEAR
Packit db3073
};
Packit db3073
Packit db3073
/* Where to chop two-digit years: i.e., for the 1930 default, numbers
Packit db3073
 * 29 and below are counted as in the year 2000, numbers 30 and above
Packit db3073
 * are counted as in the year 1900.  
Packit db3073
 */
Packit db3073
Packit db3073
static const GDateYear twodigit_start_year = 1930;
Packit db3073
Packit db3073
/* It is impossible to enter a year between 1 AD and 99 AD with this
Packit db3073
 * in effect.  
Packit db3073
 */
Packit db3073
static gboolean using_twodigit_years = FALSE;
Packit db3073
Packit db3073
/* Adjustment of locale era to AD, non-zero means using locale era
Packit db3073
 */
Packit db3073
static gint locale_era_adjust = 0;
Packit db3073
Packit db3073
struct _GDateParseTokens {
Packit db3073
  gint num_ints;
Packit db3073
  gint n[3];
Packit db3073
  guint month;
Packit db3073
};
Packit db3073
Packit db3073
typedef struct _GDateParseTokens GDateParseTokens;
Packit db3073
Packit db3073
#define NUM_LEN 10
Packit db3073
Packit db3073
/* HOLDS: g_date_global_lock */
Packit db3073
static void
Packit db3073
g_date_fill_parse_tokens (const gchar *str, GDateParseTokens *pt)
Packit db3073
{
Packit db3073
  gchar num[4][NUM_LEN+1];
Packit db3073
  gint i;
Packit db3073
  const guchar *s;
Packit db3073
  
Packit db3073
  /* We count 4, but store 3; so we can give an error
Packit db3073
   * if there are 4.
Packit db3073
   */
Packit db3073
  num[0][0] = num[1][0] = num[2][0] = num[3][0] = '\0';
Packit db3073
  
Packit db3073
  s = (const guchar *) str;
Packit db3073
  pt->num_ints = 0;
Packit db3073
  while (*s && pt->num_ints < 4) 
Packit db3073
    {
Packit db3073
      
Packit db3073
      i = 0;
Packit db3073
      while (*s && g_ascii_isdigit (*s) && i < NUM_LEN)
Packit db3073
        {
Packit db3073
          num[pt->num_ints][i] = *s;
Packit db3073
          ++s; 
Packit db3073
          ++i;
Packit db3073
        }
Packit db3073
      
Packit db3073
      if (i > 0) 
Packit db3073
        {
Packit db3073
          num[pt->num_ints][i] = '\0';
Packit db3073
          ++(pt->num_ints);
Packit db3073
        }
Packit db3073
      
Packit db3073
      if (*s == '\0') break;
Packit db3073
      
Packit db3073
      ++s;
Packit db3073
    }
Packit db3073
  
Packit db3073
  pt->n[0] = pt->num_ints > 0 ? atoi (num[0]) : 0;
Packit db3073
  pt->n[1] = pt->num_ints > 1 ? atoi (num[1]) : 0;
Packit db3073
  pt->n[2] = pt->num_ints > 2 ? atoi (num[2]) : 0;
Packit db3073
  
Packit db3073
  pt->month = G_DATE_BAD_MONTH;
Packit db3073
  
Packit db3073
  if (pt->num_ints < 3)
Packit db3073
    {
Packit db3073
      gchar *casefold;
Packit db3073
      gchar *normalized;
Packit db3073
      
Packit db3073
      casefold = g_utf8_casefold (str, -1);
Packit db3073
      normalized = g_utf8_normalize (casefold, -1, G_NORMALIZE_ALL);
Packit db3073
      g_free (casefold);
Packit db3073
Packit db3073
      i = 1;
Packit db3073
      while (i < 13)
Packit db3073
        {
Packit db3073
          if (long_month_names[i] != NULL) 
Packit db3073
            {
Packit db3073
              const gchar *found = strstr (normalized, long_month_names[i]);
Packit db3073
	      
Packit db3073
              if (found != NULL)
Packit db3073
                {
Packit db3073
                  pt->month = i;
Packit db3073
		  break;
Packit db3073
                }
Packit db3073
            }
Packit db3073
	  
Packit db3073
          if (short_month_names[i] != NULL) 
Packit db3073
            {
Packit db3073
              const gchar *found = strstr (normalized, short_month_names[i]);
Packit db3073
	      
Packit db3073
              if (found != NULL)
Packit db3073
                {
Packit db3073
                  pt->month = i;
Packit db3073
		  break;
Packit db3073
                }
Packit db3073
            }
Packit db3073
Packit db3073
          ++i;
Packit db3073
        }
Packit db3073
Packit db3073
      g_free (normalized);
Packit db3073
    }
Packit db3073
}
Packit db3073
Packit db3073
/* HOLDS: g_date_global_lock */
Packit db3073
static void
Packit db3073
g_date_prepare_to_parse (const gchar      *str, 
Packit db3073
                         GDateParseTokens *pt)
Packit db3073
{
Packit db3073
  const gchar *locale = setlocale (LC_TIME, NULL);
Packit db3073
  gboolean recompute_localeinfo = FALSE;
Packit db3073
  GDate d;
Packit db3073
  
Packit db3073
  g_return_if_fail (locale != NULL); /* should not happen */
Packit db3073
  
Packit db3073
  g_date_clear (&d, 1);              /* clear for scratch use */
Packit db3073
  
Packit db3073
  if ( (current_locale == NULL) || (strcmp (locale, current_locale) != 0) ) 
Packit db3073
    recompute_localeinfo = TRUE;  /* Uh, there used to be a reason for the temporary */
Packit db3073
  
Packit db3073
  if (recompute_localeinfo)
Packit db3073
    {
Packit db3073
      int i = 1;
Packit db3073
      GDateParseTokens testpt;
Packit db3073
      gchar buf[128];
Packit db3073
      
Packit db3073
      g_free (current_locale); /* still works if current_locale == NULL */
Packit db3073
      
Packit db3073
      current_locale = g_strdup (locale);
Packit db3073
      
Packit db3073
      short_month_names[0] = "Error";
Packit db3073
      long_month_names[0] = "Error";
Packit db3073
Packit db3073
      while (i < 13) 
Packit db3073
        {
Packit db3073
	  gchar *casefold;
Packit db3073
	  
Packit db3073
          g_date_set_dmy (&d, 1, i, 1);
Packit db3073
	  
Packit db3073
          g_return_if_fail (g_date_valid (&d);;
Packit db3073
	  
Packit db3073
          g_date_strftime (buf, 127, "%b", &d);
Packit db3073
Packit db3073
	  casefold = g_utf8_casefold (buf, -1);
Packit db3073
          g_free (short_month_names[i]);
Packit db3073
          short_month_names[i] = g_utf8_normalize (casefold, -1, G_NORMALIZE_ALL);
Packit db3073
	  g_free (casefold);
Packit db3073
	  
Packit db3073
          g_date_strftime (buf, 127, "%B", &d);
Packit db3073
	  casefold = g_utf8_casefold (buf, -1);
Packit db3073
          g_free (long_month_names[i]);
Packit db3073
          long_month_names[i] = g_utf8_normalize (casefold, -1, G_NORMALIZE_ALL);
Packit db3073
	  g_free (casefold);
Packit db3073
          
Packit db3073
          ++i;
Packit db3073
        }
Packit db3073
      
Packit db3073
      /* Determine DMY order */
Packit db3073
      
Packit db3073
      /* had to pick a random day - don't change this, some strftimes
Packit db3073
       * are broken on some days, and this one is good so far. */
Packit db3073
      g_date_set_dmy (&d, 4, 7, 1976);
Packit db3073
      
Packit db3073
      g_date_strftime (buf, 127, "%x", &d);
Packit db3073
      
Packit db3073
      g_date_fill_parse_tokens (buf, &testpt);
Packit db3073
      
Packit db3073
      i = 0;
Packit db3073
      while (i < testpt.num_ints)
Packit db3073
        {
Packit db3073
          switch (testpt.n[i])
Packit db3073
            {
Packit db3073
            case 7:
Packit db3073
              dmy_order[i] = G_DATE_MONTH;
Packit db3073
              break;
Packit db3073
            case 4:
Packit db3073
              dmy_order[i] = G_DATE_DAY;
Packit db3073
              break;
Packit db3073
            case 76:
Packit db3073
              using_twodigit_years = TRUE; /* FALL THRU */
Packit db3073
            case 1976:
Packit db3073
              dmy_order[i] = G_DATE_YEAR;
Packit db3073
              break;
Packit db3073
            default:
Packit db3073
              /* assume locale era */
Packit db3073
              locale_era_adjust = 1976 - testpt.n[i];
Packit db3073
              dmy_order[i] = G_DATE_YEAR;
Packit db3073
              break;
Packit db3073
            }
Packit db3073
          ++i;
Packit db3073
        }
Packit db3073
      
Packit db3073
#if defined(G_ENABLE_DEBUG) && 0
Packit db3073
      DEBUG_MSG (("**GDate prepared a new set of locale-specific parse rules."));
Packit db3073
      i = 1;
Packit db3073
      while (i < 13) 
Packit db3073
        {
Packit db3073
          DEBUG_MSG (("  %s   %s", long_month_names[i], short_month_names[i]));
Packit db3073
          ++i;
Packit db3073
        }
Packit db3073
      if (using_twodigit_years)
Packit db3073
        {
Packit db3073
	  DEBUG_MSG (("**Using twodigit years with cutoff year: %u", twodigit_start_year));
Packit db3073
        }
Packit db3073
      { 
Packit db3073
        gchar *strings[3];
Packit db3073
        i = 0;
Packit db3073
        while (i < 3)
Packit db3073
          {
Packit db3073
            switch (dmy_order[i])
Packit db3073
              {
Packit db3073
              case G_DATE_MONTH:
Packit db3073
                strings[i] = "Month";
Packit db3073
                break;
Packit db3073
              case G_DATE_YEAR:
Packit db3073
                strings[i] = "Year";
Packit db3073
                break;
Packit db3073
              case G_DATE_DAY:
Packit db3073
                strings[i] = "Day";
Packit db3073
                break;
Packit db3073
              default:
Packit db3073
                strings[i] = NULL;
Packit db3073
                break;
Packit db3073
              }
Packit db3073
            ++i;
Packit db3073
          }
Packit db3073
        DEBUG_MSG (("**Order: %s, %s, %s", strings[0], strings[1], strings[2]));
Packit db3073
        DEBUG_MSG (("**Sample date in this locale: `%s'", buf));
Packit db3073
      }
Packit db3073
#endif
Packit db3073
    }
Packit db3073
  
Packit db3073
  g_date_fill_parse_tokens (str, pt);
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_set_parse:
Packit db3073
 * @date: a #GDate to fill in
Packit db3073
 * @str: string to parse
Packit db3073
 *
Packit db3073
 * Parses a user-inputted string @str, and try to figure out what date it
Packit db3073
 * represents, taking the <link linkend="setlocale">current locale</link>
Packit db3073
 * into account. If the string is successfully parsed, the date will be
Packit db3073
 * valid after the call. Otherwise, it will be invalid. You should check
Packit db3073
 * using g_date_valid() to see whether the parsing succeeded.
Packit db3073
 *
Packit db3073
 * This function is not appropriate for file formats and the like; it
Packit db3073
 * isn't very precise, and its exact behavior varies with the locale.
Packit db3073
 * It's intended to be a heuristic routine that guesses what the user
Packit db3073
 * means by a given string (and it does work pretty well in that
Packit db3073
 * capacity).
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_set_parse (GDate       *d, 
Packit db3073
                  const gchar *str)
Packit db3073
{
Packit db3073
  GDateParseTokens pt;
Packit db3073
  guint m = G_DATE_BAD_MONTH, day = G_DATE_BAD_DAY, y = G_DATE_BAD_YEAR;
Packit db3073
  
Packit db3073
  g_return_if_fail (d != NULL);
Packit db3073
  
Packit db3073
  /* set invalid */
Packit db3073
  g_date_clear (d, 1);
Packit db3073
  
Packit db3073
  G_LOCK (g_date_global);
Packit db3073
Packit db3073
  g_date_prepare_to_parse (str, &pt;;
Packit db3073
  
Packit db3073
  DEBUG_MSG (("Found %d ints, `%d' `%d' `%d' and written out month %d", 
Packit db3073
	      pt.num_ints, pt.n[0], pt.n[1], pt.n[2], pt.month));
Packit db3073
  
Packit db3073
  
Packit db3073
  if (pt.num_ints == 4) 
Packit db3073
    {
Packit db3073
      G_UNLOCK (g_date_global);
Packit db3073
      return; /* presumably a typo; bail out. */
Packit db3073
    }
Packit db3073
  
Packit db3073
  if (pt.num_ints > 1)
Packit db3073
    {
Packit db3073
      int i = 0;
Packit db3073
      int j = 0;
Packit db3073
      
Packit db3073
      g_assert (pt.num_ints < 4); /* i.e., it is 2 or 3 */
Packit db3073
      
Packit db3073
      while (i < pt.num_ints && j < 3) 
Packit db3073
        {
Packit db3073
          switch (dmy_order[j])
Packit db3073
            {
Packit db3073
            case G_DATE_MONTH:
Packit db3073
	    {
Packit db3073
	      if (pt.num_ints == 2 && pt.month != G_DATE_BAD_MONTH)
Packit db3073
		{
Packit db3073
		  m = pt.month;
Packit db3073
		  ++j;      /* skip months, but don't skip this number */
Packit db3073
		  continue;
Packit db3073
		}
Packit db3073
	      else 
Packit db3073
		m = pt.n[i];
Packit db3073
	    }
Packit db3073
	    break;
Packit db3073
            case G_DATE_DAY:
Packit db3073
	    {
Packit db3073
	      if (pt.num_ints == 2 && pt.month == G_DATE_BAD_MONTH)
Packit db3073
		{
Packit db3073
		  day = 1;
Packit db3073
		  ++j;      /* skip days, since we may have month/year */
Packit db3073
		  continue;
Packit db3073
		}
Packit db3073
	      day = pt.n[i];
Packit db3073
	    }
Packit db3073
	    break;
Packit db3073
            case G_DATE_YEAR:
Packit db3073
	    {
Packit db3073
	      y  = pt.n[i];
Packit db3073
	      
Packit db3073
	      if (locale_era_adjust != 0)
Packit db3073
	        {
Packit db3073
		  y += locale_era_adjust;
Packit db3073
	        }
Packit db3073
	      else if (using_twodigit_years && y < 100)
Packit db3073
		{
Packit db3073
		  guint two     =  twodigit_start_year % 100;
Packit db3073
		  guint century = (twodigit_start_year / 100) * 100;
Packit db3073
		  
Packit db3073
		  if (y < two)
Packit db3073
		    century += 100;
Packit db3073
		  
Packit db3073
		  y += century;
Packit db3073
		}
Packit db3073
	    }
Packit db3073
	    break;
Packit db3073
            default:
Packit db3073
              break;
Packit db3073
            }
Packit db3073
	  
Packit db3073
          ++i;
Packit db3073
          ++j;
Packit db3073
        }
Packit db3073
      
Packit db3073
      
Packit db3073
      if (pt.num_ints == 3 && !g_date_valid_dmy (day, m, y))
Packit db3073
        {
Packit db3073
          /* Try YYYY MM DD */
Packit db3073
          y   = pt.n[0];
Packit db3073
          m   = pt.n[1];
Packit db3073
          day = pt.n[2];
Packit db3073
          
Packit db3073
          if (using_twodigit_years && y < 100) 
Packit db3073
            y = G_DATE_BAD_YEAR; /* avoids ambiguity */
Packit db3073
        }
Packit db3073
      else if (pt.num_ints == 2)
Packit db3073
	{
Packit db3073
	  if (m == G_DATE_BAD_MONTH && pt.month != G_DATE_BAD_MONTH)
Packit db3073
	    m = pt.month;
Packit db3073
	}
Packit db3073
    }
Packit db3073
  else if (pt.num_ints == 1) 
Packit db3073
    {
Packit db3073
      if (pt.month != G_DATE_BAD_MONTH)
Packit db3073
        {
Packit db3073
          /* Month name and year? */
Packit db3073
          m    = pt.month;
Packit db3073
          day  = 1;
Packit db3073
          y = pt.n[0];
Packit db3073
        }
Packit db3073
      else
Packit db3073
        {
Packit db3073
          /* Try yyyymmdd and yymmdd */
Packit db3073
	  
Packit db3073
          m   = (pt.n[0]/100) % 100;
Packit db3073
          day = pt.n[0] % 100;
Packit db3073
          y   = pt.n[0]/10000;
Packit db3073
	  
Packit db3073
          /* FIXME move this into a separate function */
Packit db3073
          if (using_twodigit_years && y < 100)
Packit db3073
            {
Packit db3073
              guint two     =  twodigit_start_year % 100;
Packit db3073
              guint century = (twodigit_start_year / 100) * 100;
Packit db3073
              
Packit db3073
              if (y < two)
Packit db3073
                century += 100;
Packit db3073
              
Packit db3073
              y += century;
Packit db3073
            }
Packit db3073
        }
Packit db3073
    }
Packit db3073
  
Packit db3073
  /* See if we got anything valid out of all this. */
Packit db3073
  /* y < 8000 is to catch 19998 style typos; the library is OK up to 65535 or so */
Packit db3073
  if (y < 8000 && g_date_valid_dmy (day, m, y)) 
Packit db3073
    {
Packit db3073
      d->month = m;
Packit db3073
      d->day   = day;
Packit db3073
      d->year  = y;
Packit db3073
      d->dmy   = TRUE;
Packit db3073
    }
Packit db3073
#ifdef G_ENABLE_DEBUG
Packit db3073
  else 
Packit db3073
    {
Packit db3073
      DEBUG_MSG (("Rejected DMY %u %u %u", day, m, y));
Packit db3073
    }
Packit db3073
#endif
Packit db3073
  G_UNLOCK (g_date_global);
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_set_time_t:
Packit db3073
 * @date: a #GDate 
Packit db3073
 * @timet: <type>time_t</type> value to set
Packit db3073
 *
Packit db3073
 * Sets the value of a date to the date corresponding to a time 
Packit db3073
 * specified as a time_t. The time to date conversion is done using 
Packit db3073
 * the user's current timezone.
Packit db3073
 *
Packit db3073
 * To set the value of a date to the current day, you could write:
Packit db3073
 * |[
Packit db3073
 *  g_date_set_time_t (date, time (NULL)); 
Packit db3073
 * ]|
Packit db3073
 *
Packit db3073
 * Since: 2.10
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_set_time_t (GDate *date,
Packit db3073
		   time_t timet)
Packit db3073
{
Packit db3073
  struct tm tm;
Packit db3073
  
Packit db3073
  g_return_if_fail (date != NULL);
Packit db3073
  
Packit db3073
#ifdef HAVE_LOCALTIME_R
Packit db3073
  localtime_r (&timet, &tm;;
Packit db3073
#else
Packit db3073
  {
Packit db3073
    struct tm *ptm = localtime (&timet;;
Packit db3073
Packit db3073
    if (ptm == NULL)
Packit db3073
      {
Packit db3073
	/* Happens at least in Microsoft's C library if you pass a
Packit db3073
	 * negative time_t. Use 2000-01-01 as default date.
Packit db3073
	 */
Packit db3073
#ifndef G_DISABLE_CHECKS
Packit db3073
	g_return_if_fail_warning (G_LOG_DOMAIN, "g_date_set_time", "ptm != NULL");
Packit db3073
#endif
Packit db3073
Packit db3073
	tm.tm_mon = 0;
Packit db3073
	tm.tm_mday = 1;
Packit db3073
	tm.tm_year = 100;
Packit db3073
      }
Packit db3073
    else
Packit db3073
      memcpy ((void *) &tm, (void *) ptm, sizeof(struct tm));
Packit db3073
  }
Packit db3073
#endif
Packit db3073
  
Packit db3073
  date->julian = FALSE;
Packit db3073
  
Packit db3073
  date->month = tm.tm_mon + 1;
Packit db3073
  date->day   = tm.tm_mday;
Packit db3073
  date->year  = tm.tm_year + 1900;
Packit db3073
  
Packit db3073
  g_return_if_fail (g_date_valid_dmy (date->day, date->month, date->year));
Packit db3073
  
Packit db3073
  date->dmy    = TRUE;
Packit db3073
}
Packit db3073
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_set_time:
Packit db3073
 * @date: a #GDate.
Packit db3073
 * @time_: #GTime value to set.
Packit db3073
 *
Packit db3073
 * Sets the value of a date from a #GTime value.
Packit db3073
 * The time to date conversion is done using the user's current timezone.
Packit db3073
 *
Packit db3073
 * Deprecated: 2.10: Use g_date_set_time_t() instead.
Packit db3073
 */
Packit db3073
void
Packit db3073
g_date_set_time (GDate *date,
Packit db3073
		 GTime  time_)
Packit db3073
{
Packit db3073
  g_date_set_time_t (date, (time_t) time_);
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_set_time_val:
Packit db3073
 * @date: a #GDate 
Packit db3073
 * @timeval: #GTimeVal value to set
Packit db3073
 *
Packit db3073
 * Sets the value of a date from a #GTimeVal value.  Note that the
Packit db3073
 * @tv_usec member is ignored, because #GDate can't make use of the
Packit db3073
 * additional precision.
Packit db3073
 *
Packit db3073
 * The time to date conversion is done using the user's current timezone.
Packit db3073
 *
Packit db3073
 * Since: 2.10
Packit db3073
 */
Packit db3073
void
Packit db3073
g_date_set_time_val (GDate    *date,
Packit db3073
		     GTimeVal *timeval)
Packit db3073
{
Packit db3073
  g_date_set_time_t (date, (time_t) timeval->tv_sec);
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_set_month:
Packit db3073
 * @date: a #GDate
Packit db3073
 * @month: month to set
Packit db3073
 *
Packit db3073
 * Sets the month of the year for a #GDate.  If the resulting
Packit db3073
 * day-month-year triplet is invalid, the date will be invalid.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_set_month (GDate     *d, 
Packit db3073
                  GDateMonth m)
Packit db3073
{
Packit db3073
  g_return_if_fail (d != NULL);
Packit db3073
  g_return_if_fail (g_date_valid_month (m));
Packit db3073
Packit db3073
  if (d->julian && !d->dmy) g_date_update_dmy(d);
Packit db3073
  d->julian = FALSE;
Packit db3073
  
Packit db3073
  d->month = m;
Packit db3073
  
Packit db3073
  if (g_date_valid_dmy (d->day, d->month, d->year))
Packit db3073
    d->dmy = TRUE;
Packit db3073
  else 
Packit db3073
    d->dmy = FALSE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_set_day:
Packit db3073
 * @date: a #GDate
Packit db3073
 * @day: day to set
Packit db3073
 *
Packit db3073
 * Sets the day of the month for a #GDate. If the resulting
Packit db3073
 * day-month-year triplet is invalid, the date will be invalid.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_set_day (GDate    *d, 
Packit db3073
                GDateDay  day)
Packit db3073
{
Packit db3073
  g_return_if_fail (d != NULL);
Packit db3073
  g_return_if_fail (g_date_valid_day (day));
Packit db3073
  
Packit db3073
  if (d->julian && !d->dmy) g_date_update_dmy(d);
Packit db3073
  d->julian = FALSE;
Packit db3073
  
Packit db3073
  d->day = day;
Packit db3073
  
Packit db3073
  if (g_date_valid_dmy (d->day, d->month, d->year))
Packit db3073
    d->dmy = TRUE;
Packit db3073
  else 
Packit db3073
    d->dmy = FALSE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_set_year:
Packit db3073
 * @date: a #GDate
Packit db3073
 * @year: year to set
Packit db3073
 *
Packit db3073
 * Sets the year for a #GDate. If the resulting day-month-year
Packit db3073
 * triplet is invalid, the date will be invalid.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_set_year (GDate     *d, 
Packit db3073
                 GDateYear  y)
Packit db3073
{
Packit db3073
  g_return_if_fail (d != NULL);
Packit db3073
  g_return_if_fail (g_date_valid_year (y));
Packit db3073
  
Packit db3073
  if (d->julian && !d->dmy) g_date_update_dmy(d);
Packit db3073
  d->julian = FALSE;
Packit db3073
  
Packit db3073
  d->year = y;
Packit db3073
  
Packit db3073
  if (g_date_valid_dmy (d->day, d->month, d->year))
Packit db3073
    d->dmy = TRUE;
Packit db3073
  else 
Packit db3073
    d->dmy = FALSE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_set_dmy:
Packit db3073
 * @date: a #GDate
Packit db3073
 * @day: day
Packit db3073
 * @month: month
Packit db3073
 * @y: year
Packit db3073
 *
Packit db3073
 * Sets the value of a #GDate from a day, month, and year.
Packit db3073
 * The day-month-year triplet must be valid; if you aren't
Packit db3073
 * sure it is, call g_date_valid_dmy() to check before you
Packit db3073
 * set it.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_set_dmy (GDate      *d, 
Packit db3073
                GDateDay    day, 
Packit db3073
                GDateMonth  m, 
Packit db3073
                GDateYear   y)
Packit db3073
{
Packit db3073
  g_return_if_fail (d != NULL);
Packit db3073
  g_return_if_fail (g_date_valid_dmy (day, m, y));
Packit db3073
  
Packit db3073
  d->julian = FALSE;
Packit db3073
  
Packit db3073
  d->month = m;
Packit db3073
  d->day   = day;
Packit db3073
  d->year  = y;
Packit db3073
  
Packit db3073
  d->dmy = TRUE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_set_julian:
Packit db3073
 * @date: a #GDate
Packit db3073
 * @julian_date: Julian day number (days since January 1, Year 1)
Packit db3073
 *
Packit db3073
 * Sets the value of a #GDate from a Julian day number.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_set_julian (GDate   *d, 
Packit db3073
                   guint32  j)
Packit db3073
{
Packit db3073
  g_return_if_fail (d != NULL);
Packit db3073
  g_return_if_fail (g_date_valid_julian (j));
Packit db3073
  
Packit db3073
  d->julian_days = j;
Packit db3073
  d->julian = TRUE;
Packit db3073
  d->dmy = FALSE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_is_first_of_month:
Packit db3073
 * @date: a #GDate to check
Packit db3073
 *
Packit db3073
 * Returns %TRUE if the date is on the first of a month.
Packit db3073
 * The date must be valid.
Packit db3073
 *
Packit db3073
 * Returns: %TRUE if the date is the first of the month
Packit db3073
 */
Packit db3073
gboolean     
Packit db3073
g_date_is_first_of_month (const GDate *d)
Packit db3073
{
Packit db3073
  g_return_val_if_fail (g_date_valid (d), FALSE);
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->dmy, FALSE);  
Packit db3073
  
Packit db3073
  if (d->day == 1) return TRUE;
Packit db3073
  else return FALSE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_is_last_of_month:
Packit db3073
 * @date: a #GDate to check
Packit db3073
 *
Packit db3073
 * Returns %TRUE if the date is the last day of the month.
Packit db3073
 * The date must be valid.
Packit db3073
 *
Packit db3073
 * Returns: %TRUE if the date is the last day of the month
Packit db3073
 */
Packit db3073
gboolean     
Packit db3073
g_date_is_last_of_month (const GDate *d)
Packit db3073
{
Packit db3073
  gint idx;
Packit db3073
  
Packit db3073
  g_return_val_if_fail (g_date_valid (d), FALSE);
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_val_if_fail (d->dmy, FALSE);  
Packit db3073
  
Packit db3073
  idx = g_date_is_leap_year (d->year) ? 1 : 0;
Packit db3073
  
Packit db3073
  if (d->day == days_in_months[idx][d->month]) return TRUE;
Packit db3073
  else return FALSE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_add_days:
Packit db3073
 * @date: a #GDate to increment
Packit db3073
 * @n_days: number of days to move the date forward
Packit db3073
 *
Packit db3073
 * Increments a date some number of days.
Packit db3073
 * To move forward by weeks, add weeks*7 days.
Packit db3073
 * The date must be valid.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_add_days (GDate *d, 
Packit db3073
                 guint  ndays)
Packit db3073
{
Packit db3073
  g_return_if_fail (g_date_valid (d));
Packit db3073
  
Packit db3073
  if (!d->julian)
Packit db3073
    g_date_update_julian (d);
Packit db3073
Packit db3073
  g_return_if_fail (d->julian);
Packit db3073
  
Packit db3073
  d->julian_days += ndays;
Packit db3073
  d->dmy = FALSE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_subtract_days:
Packit db3073
 * @date: a #GDate to decrement
Packit db3073
 * @n_days: number of days to move
Packit db3073
 *
Packit db3073
 * Moves a date some number of days into the past.
Packit db3073
 * To move by weeks, just move by weeks*7 days.
Packit db3073
 * The date must be valid.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_subtract_days (GDate *d, 
Packit db3073
                      guint  ndays)
Packit db3073
{
Packit db3073
  g_return_if_fail (g_date_valid (d));
Packit db3073
  
Packit db3073
  if (!d->julian)
Packit db3073
    g_date_update_julian (d);
Packit db3073
Packit db3073
  g_return_if_fail (d->julian);
Packit db3073
  g_return_if_fail (d->julian_days > ndays);
Packit db3073
  
Packit db3073
  d->julian_days -= ndays;
Packit db3073
  d->dmy = FALSE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_add_months:
Packit db3073
 * @date: a #GDate to increment
Packit db3073
 * @n_months: number of months to move forward
Packit db3073
 *
Packit db3073
 * Increments a date by some number of months.
Packit db3073
 * If the day of the month is greater than 28,
Packit db3073
 * this routine may change the day of the month
Packit db3073
 * (because the destination month may not have
Packit db3073
 * the current day in it). The date must be valid.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_add_months (GDate *d, 
Packit db3073
                   guint  nmonths)
Packit db3073
{
Packit db3073
  guint years, months;
Packit db3073
  gint idx;
Packit db3073
  
Packit db3073
  g_return_if_fail (g_date_valid (d));
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_if_fail (d->dmy);  
Packit db3073
  
Packit db3073
  nmonths += d->month - 1;
Packit db3073
  
Packit db3073
  years  = nmonths/12;
Packit db3073
  months = nmonths%12;
Packit db3073
  
Packit db3073
  d->month = months + 1;
Packit db3073
  d->year  += years;
Packit db3073
  
Packit db3073
  idx = g_date_is_leap_year (d->year) ? 1 : 0;
Packit db3073
  
Packit db3073
  if (d->day > days_in_months[idx][d->month])
Packit db3073
    d->day = days_in_months[idx][d->month];
Packit db3073
  
Packit db3073
  d->julian = FALSE;
Packit db3073
  
Packit db3073
  g_return_if_fail (g_date_valid (d));
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_subtract_months:
Packit db3073
 * @date: a #GDate to decrement
Packit db3073
 * @n_months: number of months to move
Packit db3073
 *
Packit db3073
 * Moves a date some number of months into the past.
Packit db3073
 * If the current day of the month doesn't exist in
Packit db3073
 * the destination month, the day of the month
Packit db3073
 * may change. The date must be valid.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_subtract_months (GDate *d, 
Packit db3073
                        guint  nmonths)
Packit db3073
{
Packit db3073
  guint years, months;
Packit db3073
  gint idx;
Packit db3073
  
Packit db3073
  g_return_if_fail (g_date_valid (d));
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_if_fail (d->dmy);  
Packit db3073
  
Packit db3073
  years  = nmonths/12;
Packit db3073
  months = nmonths%12;
Packit db3073
  
Packit db3073
  g_return_if_fail (d->year > years);
Packit db3073
  
Packit db3073
  d->year  -= years;
Packit db3073
  
Packit db3073
  if (d->month > months) d->month -= months;
Packit db3073
  else 
Packit db3073
    {
Packit db3073
      months -= d->month;
Packit db3073
      d->month = 12 - months;
Packit db3073
      d->year -= 1;
Packit db3073
    }
Packit db3073
  
Packit db3073
  idx = g_date_is_leap_year (d->year) ? 1 : 0;
Packit db3073
  
Packit db3073
  if (d->day > days_in_months[idx][d->month])
Packit db3073
    d->day = days_in_months[idx][d->month];
Packit db3073
  
Packit db3073
  d->julian = FALSE;
Packit db3073
  
Packit db3073
  g_return_if_fail (g_date_valid (d));
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_add_years:
Packit db3073
 * @date: a #GDate to increment
Packit db3073
 * @n_years: number of years to move forward
Packit db3073
 *
Packit db3073
 * Increments a date by some number of years.
Packit db3073
 * If the date is February 29, and the destination
Packit db3073
 * year is not a leap year, the date will be changed
Packit db3073
 * to February 28. The date must be valid.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_add_years (GDate *d, 
Packit db3073
                  guint  nyears)
Packit db3073
{
Packit db3073
  g_return_if_fail (g_date_valid (d));
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_if_fail (d->dmy);  
Packit db3073
  
Packit db3073
  d->year += nyears;
Packit db3073
  
Packit db3073
  if (d->month == 2 && d->day == 29)
Packit db3073
    {
Packit db3073
      if (!g_date_is_leap_year (d->year))
Packit db3073
        d->day = 28;
Packit db3073
    }
Packit db3073
  
Packit db3073
  d->julian = FALSE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_subtract_years:
Packit db3073
 * @date: a #GDate to decrement
Packit db3073
 * @n_years: number of years to move
Packit db3073
 *
Packit db3073
 * Moves a date some number of years into the past.
Packit db3073
 * If the current day doesn't exist in the destination
Packit db3073
 * year (i.e. it's February 29 and you move to a non-leap-year)
Packit db3073
 * then the day is changed to February 29. The date
Packit db3073
 * must be valid.
Packit db3073
 */
Packit db3073
void         
Packit db3073
g_date_subtract_years (GDate *d, 
Packit db3073
                       guint  nyears)
Packit db3073
{
Packit db3073
  g_return_if_fail (g_date_valid (d));
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_if_fail (d->dmy);  
Packit db3073
  g_return_if_fail (d->year > nyears);
Packit db3073
  
Packit db3073
  d->year -= nyears;
Packit db3073
  
Packit db3073
  if (d->month == 2 && d->day == 29)
Packit db3073
    {
Packit db3073
      if (!g_date_is_leap_year (d->year))
Packit db3073
        d->day = 28;
Packit db3073
    }
Packit db3073
  
Packit db3073
  d->julian = FALSE;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_is_leap_year:
Packit db3073
 * @year: year to check
Packit db3073
 *
Packit db3073
 * Returns %TRUE if the year is a leap year.
Packit db3073
 * <footnote><para>For the purposes of this function,
Packit db3073
 * leap year is every year divisible by 4 unless that year
Packit db3073
 * is divisible by 100. If it is divisible by 100 it would
Packit db3073
 * be a leap year only if that year is also divisible
Packit db3073
 * by 400.</para></footnote>
Packit db3073
 *
Packit db3073
 * Returns: %TRUE if the year is a leap year
Packit db3073
 */
Packit db3073
gboolean     
Packit db3073
g_date_is_leap_year (GDateYear year)
Packit db3073
{
Packit db3073
  g_return_val_if_fail (g_date_valid_year (year), FALSE);
Packit db3073
  
Packit db3073
  return ( (((year % 4) == 0) && ((year % 100) != 0)) ||
Packit db3073
           (year % 400) == 0 );
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_days_in_month:
Packit db3073
 * @month: month
Packit db3073
 * @year: year
Packit db3073
 *
Packit db3073
 * Returns the number of days in a month, taking leap
Packit db3073
 * years into account.
Packit db3073
 *
Packit db3073
 * Returns: number of days in @month during the @year
Packit db3073
 */
Packit db3073
guint8         
Packit db3073
g_date_get_days_in_month (GDateMonth month, 
Packit db3073
                          GDateYear  year)
Packit db3073
{
Packit db3073
  gint idx;
Packit db3073
  
Packit db3073
  g_return_val_if_fail (g_date_valid_year (year), 0);
Packit db3073
  g_return_val_if_fail (g_date_valid_month (month), 0);
Packit db3073
  
Packit db3073
  idx = g_date_is_leap_year (year) ? 1 : 0;
Packit db3073
  
Packit db3073
  return days_in_months[idx][month];
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_monday_weeks_in_year:
Packit db3073
 * @year: a year
Packit db3073
 *
Packit db3073
 * Returns the number of weeks in the year, where weeks
Packit db3073
 * are taken to start on Monday. Will be 52 or 53. The
Packit db3073
 * date must be valid. (Years always have 52 7-day periods,
Packit db3073
 * plus 1 or 2 extra days depending on whether it's a leap
Packit db3073
 * year. This function is basically telling you how many
Packit db3073
 * Mondays are in the year, i.e. there are 53 Mondays if
Packit db3073
 * one of the extra days happens to be a Monday.)
Packit db3073
 *
Packit db3073
 * Returns: number of Mondays in the year
Packit db3073
 */
Packit db3073
guint8       
Packit db3073
g_date_get_monday_weeks_in_year (GDateYear year)
Packit db3073
{
Packit db3073
  GDate d;
Packit db3073
  
Packit db3073
  g_return_val_if_fail (g_date_valid_year (year), 0);
Packit db3073
  
Packit db3073
  g_date_clear (&d, 1);
Packit db3073
  g_date_set_dmy (&d, 1, 1, year);
Packit db3073
  if (g_date_get_weekday (&d) == G_DATE_MONDAY) return 53;
Packit db3073
  g_date_set_dmy (&d, 31, 12, year);
Packit db3073
  if (g_date_get_weekday (&d) == G_DATE_MONDAY) return 53;
Packit db3073
  if (g_date_is_leap_year (year)) 
Packit db3073
    {
Packit db3073
      g_date_set_dmy (&d, 2, 1, year);
Packit db3073
      if (g_date_get_weekday (&d) == G_DATE_MONDAY) return 53;
Packit db3073
      g_date_set_dmy (&d, 30, 12, year);
Packit db3073
      if (g_date_get_weekday (&d) == G_DATE_MONDAY) return 53;
Packit db3073
    }
Packit db3073
  return 52;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_get_sunday_weeks_in_year:
Packit db3073
 * @year: year to count weeks in
Packit db3073
 *
Packit db3073
 * Returns the number of weeks in the year, where weeks
Packit db3073
 * are taken to start on Sunday. Will be 52 or 53. The
Packit db3073
 * date must be valid. (Years always have 52 7-day periods,
Packit db3073
 * plus 1 or 2 extra days depending on whether it's a leap
Packit db3073
 * year. This function is basically telling you how many
Packit db3073
 * Sundays are in the year, i.e. there are 53 Sundays if
Packit db3073
 * one of the extra days happens to be a Sunday.)
Packit db3073
 *
Packit db3073
 * Returns: the number of weeks in @year
Packit db3073
 */
Packit db3073
guint8       
Packit db3073
g_date_get_sunday_weeks_in_year (GDateYear year)
Packit db3073
{
Packit db3073
  GDate d;
Packit db3073
  
Packit db3073
  g_return_val_if_fail (g_date_valid_year (year), 0);
Packit db3073
  
Packit db3073
  g_date_clear (&d, 1);
Packit db3073
  g_date_set_dmy (&d, 1, 1, year);
Packit db3073
  if (g_date_get_weekday (&d) == G_DATE_SUNDAY) return 53;
Packit db3073
  g_date_set_dmy (&d, 31, 12, year);
Packit db3073
  if (g_date_get_weekday (&d) == G_DATE_SUNDAY) return 53;
Packit db3073
  if (g_date_is_leap_year (year)) 
Packit db3073
    {
Packit db3073
      g_date_set_dmy (&d, 2, 1, year);
Packit db3073
      if (g_date_get_weekday (&d) == G_DATE_SUNDAY) return 53;
Packit db3073
      g_date_set_dmy (&d, 30, 12, year);
Packit db3073
      if (g_date_get_weekday (&d) == G_DATE_SUNDAY) return 53;
Packit db3073
    }
Packit db3073
  return 52;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_compare:
Packit db3073
 * @lhs: first date to compare
Packit db3073
 * @rhs: second date to compare
Packit db3073
 *
Packit db3073
 * qsort()-style comparison function for dates.
Packit db3073
 * Both dates must be valid.
Packit db3073
 *
Packit db3073
 * Returns: 0 for equal, less than zero if @lhs is less than @rhs,
Packit db3073
 *     greater than zero if @lhs is greater than @rhs
Packit db3073
 */
Packit db3073
gint         
Packit db3073
g_date_compare (const GDate *lhs, 
Packit db3073
                const GDate *rhs)
Packit db3073
{
Packit db3073
  g_return_val_if_fail (lhs != NULL, 0);
Packit db3073
  g_return_val_if_fail (rhs != NULL, 0);
Packit db3073
  g_return_val_if_fail (g_date_valid (lhs), 0);
Packit db3073
  g_return_val_if_fail (g_date_valid (rhs), 0);
Packit db3073
  
Packit db3073
  /* Remember the self-comparison case! I think it works right now. */
Packit db3073
  
Packit db3073
  while (TRUE)
Packit db3073
    {
Packit db3073
      if (lhs->julian && rhs->julian) 
Packit db3073
        {
Packit db3073
          if (lhs->julian_days < rhs->julian_days) return -1;
Packit db3073
          else if (lhs->julian_days > rhs->julian_days) return 1;
Packit db3073
          else                                          return 0;
Packit db3073
        }
Packit db3073
      else if (lhs->dmy && rhs->dmy) 
Packit db3073
        {
Packit db3073
          if (lhs->year < rhs->year)               return -1;
Packit db3073
          else if (lhs->year > rhs->year)               return 1;
Packit db3073
          else 
Packit db3073
            {
Packit db3073
              if (lhs->month < rhs->month)         return -1;
Packit db3073
              else if (lhs->month > rhs->month)         return 1;
Packit db3073
              else 
Packit db3073
                {
Packit db3073
                  if (lhs->day < rhs->day)              return -1;
Packit db3073
                  else if (lhs->day > rhs->day)              return 1;
Packit db3073
                  else                                       return 0;
Packit db3073
                }
Packit db3073
              
Packit db3073
            }
Packit db3073
          
Packit db3073
        }
Packit db3073
      else
Packit db3073
        {
Packit db3073
          if (!lhs->julian) g_date_update_julian (lhs);
Packit db3073
          if (!rhs->julian) g_date_update_julian (rhs);
Packit db3073
          g_return_val_if_fail (lhs->julian, 0);
Packit db3073
          g_return_val_if_fail (rhs->julian, 0);
Packit db3073
        }
Packit db3073
      
Packit db3073
    }
Packit db3073
  return 0; /* warnings */
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_to_struct_tm:
Packit db3073
 * @date: a #GDate to set the <structname>struct tm</structname> from
Packit db3073
 * @tm: <structname>struct tm</structname> to fill
Packit db3073
 *
Packit db3073
 * Fills in the date-related bits of a <structname>struct tm</structname>
Packit db3073
 * using the @date value. Initializes the non-date parts with something
Packit db3073
 * sane but meaningless.
Packit db3073
 */
Packit db3073
void        
Packit db3073
g_date_to_struct_tm (const GDate *d, 
Packit db3073
                     struct tm   *tm)
Packit db3073
{
Packit db3073
  GDateWeekday day;
Packit db3073
     
Packit db3073
  g_return_if_fail (g_date_valid (d));
Packit db3073
  g_return_if_fail (tm != NULL);
Packit db3073
  
Packit db3073
  if (!d->dmy) 
Packit db3073
    g_date_update_dmy (d);
Packit db3073
Packit db3073
  g_return_if_fail (d->dmy);
Packit db3073
  
Packit db3073
  /* zero all the irrelevant fields to be sure they're valid */
Packit db3073
  
Packit db3073
  /* On Linux and maybe other systems, there are weird non-POSIX
Packit db3073
   * fields on the end of struct tm that choke strftime if they
Packit db3073
   * contain garbage.  So we need to 0 the entire struct, not just the
Packit db3073
   * fields we know to exist. 
Packit db3073
   */
Packit db3073
  
Packit db3073
  memset (tm, 0x0, sizeof (struct tm));
Packit db3073
  
Packit db3073
  tm->tm_mday = d->day;
Packit db3073
  tm->tm_mon  = d->month - 1; /* 0-11 goes in tm */
Packit db3073
  tm->tm_year = ((int)d->year) - 1900; /* X/Open says tm_year can be negative */
Packit db3073
  
Packit db3073
  day = g_date_get_weekday (d);
Packit db3073
  if (day == 7) day = 0; /* struct tm wants days since Sunday, so Sunday is 0 */
Packit db3073
  
Packit db3073
  tm->tm_wday = (int)day;
Packit db3073
  
Packit db3073
  tm->tm_yday = g_date_get_day_of_year (d) - 1; /* 0 to 365 */
Packit db3073
  tm->tm_isdst = -1; /* -1 means "information not available" */
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_clamp:
Packit db3073
 * @date: a #GDate to clamp
Packit db3073
 * @min_date: minimum accepted value for @date
Packit db3073
 * @max_date: maximum accepted value for @date
Packit db3073
 *
Packit db3073
 * If @date is prior to @min_date, sets @date equal to @min_date.
Packit db3073
 * If @date falls after @max_date, sets @date equal to @max_date.
Packit db3073
 * Otherwise, @date is unchanged.
Packit db3073
 * Either of @min_date and @max_date may be %NULL.
Packit db3073
 * All non-%NULL dates must be valid.
Packit db3073
 */
Packit db3073
void
Packit db3073
g_date_clamp (GDate       *date,
Packit db3073
	      const GDate *min_date,
Packit db3073
	      const GDate *max_date)
Packit db3073
{
Packit db3073
  g_return_if_fail (g_date_valid (date));
Packit db3073
Packit db3073
  if (min_date != NULL)
Packit db3073
    g_return_if_fail (g_date_valid (min_date));
Packit db3073
Packit db3073
  if (max_date != NULL)
Packit db3073
    g_return_if_fail (g_date_valid (max_date));
Packit db3073
Packit db3073
  if (min_date != NULL && max_date != NULL)
Packit db3073
    g_return_if_fail (g_date_compare (min_date, max_date) <= 0);
Packit db3073
Packit db3073
  if (min_date && g_date_compare (date, min_date) < 0)
Packit db3073
    *date = *min_date;
Packit db3073
Packit db3073
  if (max_date && g_date_compare (max_date, date) < 0)
Packit db3073
    *date = *max_date;
Packit db3073
}
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_order:
Packit db3073
 * @date1: the first date
Packit db3073
 * @date2: the second date
Packit db3073
 *
Packit db3073
 * Checks if @date1 is less than or equal to @date2,
Packit db3073
 * and swap the values if this is not the case.
Packit db3073
 */
Packit db3073
void
Packit db3073
g_date_order (GDate *date1,
Packit db3073
              GDate *date2)
Packit db3073
{
Packit db3073
  g_return_if_fail (g_date_valid (date1));
Packit db3073
  g_return_if_fail (g_date_valid (date2));
Packit db3073
Packit db3073
  if (g_date_compare (date1, date2) > 0)
Packit db3073
    {
Packit db3073
      GDate tmp = *date1;
Packit db3073
      *date1 = *date2;
Packit db3073
      *date2 = tmp;
Packit db3073
    }
Packit db3073
}
Packit db3073
Packit db3073
#ifdef G_OS_WIN32
Packit db3073
static gsize
Packit db3073
win32_strftime_helper (const GDate     *d,
Packit db3073
		       const gchar     *format,
Packit db3073
		       const struct tm *tm,
Packit db3073
		       gchar           *s,
Packit db3073
		       gsize	        slen)
Packit db3073
{
Packit db3073
  SYSTEMTIME systemtime;
Packit db3073
  TIME_ZONE_INFORMATION tzinfo;
Packit db3073
  LCID lcid;
Packit db3073
  int n, k;
Packit db3073
  GArray *result;
Packit db3073
  const gchar *p;
Packit db3073
  gunichar c;
Packit db3073
  const wchar_t digits[] = L"0123456789";
Packit db3073
  gchar *convbuf;
Packit db3073
  glong convlen = 0;
Packit db3073
  gsize retval;
Packit db3073
Packit db3073
  systemtime.wYear = tm->tm_year + 1900;
Packit db3073
  systemtime.wMonth = tm->tm_mon + 1;
Packit db3073
  systemtime.wDayOfWeek = tm->tm_wday;
Packit db3073
  systemtime.wDay = tm->tm_mday;
Packit db3073
  systemtime.wHour = tm->tm_hour;
Packit db3073
  systemtime.wMinute = tm->tm_min;
Packit db3073
  systemtime.wSecond = tm->tm_sec;
Packit db3073
  systemtime.wMilliseconds = 0;
Packit db3073
  
Packit db3073
  lcid = GetThreadLocale ();
Packit db3073
  result = g_array_sized_new (FALSE, FALSE, sizeof (wchar_t), MAX (128, strlen (format) * 2));
Packit db3073
Packit db3073
  p = format;
Packit db3073
  while (*p)
Packit db3073
    {
Packit db3073
      c = g_utf8_get_char (p);
Packit db3073
      if (c == '%')
Packit db3073
	{
Packit db3073
	  p = g_utf8_next_char (p);
Packit db3073
	  if (!*p)
Packit db3073
	    {
Packit db3073
	      s[0] = '\0';
Packit db3073
	      g_array_free (result, TRUE);
Packit db3073
Packit db3073
	      return 0;
Packit db3073
	    }
Packit db3073
	  
Packit db3073
	  c = g_utf8_get_char (p);
Packit db3073
	  if (c == 'E' || c == 'O')
Packit db3073
	    {
Packit db3073
	      /* Ignore modified conversion specifiers for now. */
Packit db3073
	      p = g_utf8_next_char (p);
Packit db3073
	      if (!*p)
Packit db3073
		{
Packit db3073
		  s[0] = '\0';
Packit db3073
		  g_array_free (result, TRUE);
Packit db3073
		  
Packit db3073
		  return 0;
Packit db3073
		}
Packit db3073
Packit db3073
	      c = g_utf8_get_char (p);
Packit db3073
	    }
Packit db3073
Packit db3073
	  switch (c)
Packit db3073
	    {
Packit db3073
	    case 'a':
Packit db3073
	      if (systemtime.wDayOfWeek == 0)
Packit db3073
		k = 6;
Packit db3073
	      else
Packit db3073
		k = systemtime.wDayOfWeek - 1;
Packit db3073
	      n = GetLocaleInfoW (lcid, LOCALE_SABBREVDAYNAME1+k, NULL, 0);
Packit db3073
	      g_array_set_size (result, result->len + n);
Packit db3073
	      GetLocaleInfoW (lcid, LOCALE_SABBREVDAYNAME1+k, ((wchar_t *) result->data) + result->len - n, n);
Packit db3073
	      g_array_set_size (result, result->len - 1);
Packit db3073
	      break;
Packit db3073
	    case 'A':
Packit db3073
	      if (systemtime.wDayOfWeek == 0)
Packit db3073
		k = 6;
Packit db3073
	      else
Packit db3073
		k = systemtime.wDayOfWeek - 1;
Packit db3073
	      n = GetLocaleInfoW (lcid, LOCALE_SDAYNAME1+k, NULL, 0);
Packit db3073
	      g_array_set_size (result, result->len + n);
Packit db3073
	      GetLocaleInfoW (lcid, LOCALE_SDAYNAME1+k, ((wchar_t *) result->data) + result->len - n, n);
Packit db3073
	      g_array_set_size (result, result->len - 1);
Packit db3073
	      break;
Packit db3073
	    case 'b':
Packit db3073
	    case 'h':
Packit db3073
	      n = GetLocaleInfoW (lcid, LOCALE_SABBREVMONTHNAME1+systemtime.wMonth-1, NULL, 0);
Packit db3073
	      g_array_set_size (result, result->len + n);
Packit db3073
	      GetLocaleInfoW (lcid, LOCALE_SABBREVMONTHNAME1+systemtime.wMonth-1, ((wchar_t *) result->data) + result->len - n, n);
Packit db3073
	      g_array_set_size (result, result->len - 1);
Packit db3073
	      break;
Packit db3073
	    case 'B':
Packit db3073
	      n = GetLocaleInfoW (lcid, LOCALE_SMONTHNAME1+systemtime.wMonth-1, NULL, 0);
Packit db3073
	      g_array_set_size (result, result->len + n);
Packit db3073
	      GetLocaleInfoW (lcid, LOCALE_SMONTHNAME1+systemtime.wMonth-1, ((wchar_t *) result->data) + result->len - n, n);
Packit db3073
	      g_array_set_size (result, result->len - 1);
Packit db3073
	      break;
Packit db3073
	    case 'c':
Packit db3073
	      n = GetDateFormatW (lcid, 0, &systemtime, NULL, NULL, 0);
Packit db3073
	      if (n > 0)
Packit db3073
		{
Packit db3073
		  g_array_set_size (result, result->len + n);
Packit db3073
		  GetDateFormatW (lcid, 0, &systemtime, NULL, ((wchar_t *) result->data) + result->len - n, n);
Packit db3073
		  g_array_set_size (result, result->len - 1);
Packit db3073
		}
Packit db3073
	      g_array_append_vals (result, L" ", 1);
Packit db3073
	      n = GetTimeFormatW (lcid, 0, &systemtime, NULL, NULL, 0);
Packit db3073
	      if (n > 0)
Packit db3073
		{
Packit db3073
		  g_array_set_size (result, result->len + n);
Packit db3073
		  GetTimeFormatW (lcid, 0, &systemtime, NULL, ((wchar_t *) result->data) + result->len - n, n);
Packit db3073
		  g_array_set_size (result, result->len - 1);
Packit db3073
		}
Packit db3073
	      break;
Packit db3073
	    case 'C':
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wYear/1000, 1);
Packit db3073
	      g_array_append_vals (result, digits + (systemtime.wYear/1000)%10, 1);
Packit db3073
	      break;
Packit db3073
	    case 'd':
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wDay/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wDay%10, 1);
Packit db3073
	      break;
Packit db3073
	    case 'D':
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMonth/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMonth%10, 1);
Packit db3073
	      g_array_append_vals (result, L"/", 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wDay/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wDay%10, 1);
Packit db3073
	      g_array_append_vals (result, L"/", 1);
Packit db3073
	      g_array_append_vals (result, digits + (systemtime.wYear/10)%10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wYear%10, 1);
Packit db3073
	      break;
Packit db3073
	    case 'e':
Packit db3073
	      if (systemtime.wDay >= 10)
Packit db3073
		g_array_append_vals (result, digits + systemtime.wDay/10, 1);
Packit db3073
	      else
Packit db3073
		g_array_append_vals (result, L" ", 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wDay%10, 1);
Packit db3073
	      break;
Packit db3073
Packit db3073
	      /* A GDate has no time fields, so for now we can
Packit db3073
	       * hardcode all time conversions into zeros (or 12 for
Packit db3073
	       * %I). The alternative code snippets in the #else
Packit db3073
	       * branches are here ready to be taken into use when
Packit db3073
	       * needed by a g_strftime() or g_date_and_time_format()
Packit db3073
	       * or whatever.
Packit db3073
	       */
Packit db3073
	    case 'H':
Packit db3073
#if 1
Packit db3073
	      g_array_append_vals (result, L"00", 2);
Packit db3073
#else
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wHour/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wHour%10, 1);
Packit db3073
#endif
Packit db3073
	      break;
Packit db3073
	    case 'I':
Packit db3073
#if 1
Packit db3073
	      g_array_append_vals (result, L"12", 2);
Packit db3073
#else
Packit db3073
	      if (systemtime.wHour == 0)
Packit db3073
		g_array_append_vals (result, L"12", 2);
Packit db3073
	      else
Packit db3073
		{
Packit db3073
		  g_array_append_vals (result, digits + (systemtime.wHour%12)/10, 1);
Packit db3073
		  g_array_append_vals (result, digits + (systemtime.wHour%12)%10, 1);
Packit db3073
		}
Packit db3073
#endif
Packit db3073
	      break;
Packit db3073
	    case  'j':
Packit db3073
	      g_array_append_vals (result, digits + (tm->tm_yday+1)/100, 1);
Packit db3073
	      g_array_append_vals (result, digits + ((tm->tm_yday+1)/10)%10, 1);
Packit db3073
	      g_array_append_vals (result, digits + (tm->tm_yday+1)%10, 1);
Packit db3073
	      break;
Packit db3073
	    case 'm':
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMonth/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMonth%10, 1);
Packit db3073
	      break;
Packit db3073
	    case 'M':
Packit db3073
#if 1
Packit db3073
	      g_array_append_vals (result, L"00", 2);
Packit db3073
#else
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMinute/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMinute%10, 1);
Packit db3073
#endif
Packit db3073
	      break;
Packit db3073
	    case 'n':
Packit db3073
	      g_array_append_vals (result, L"\n", 1);
Packit db3073
	      break;
Packit db3073
	    case 'p':
Packit db3073
	      n = GetTimeFormatW (lcid, 0, &systemtime, L"tt", NULL, 0);
Packit db3073
	      if (n > 0)
Packit db3073
		{
Packit db3073
		  g_array_set_size (result, result->len + n);
Packit db3073
		  GetTimeFormatW (lcid, 0, &systemtime, L"tt", ((wchar_t *) result->data) + result->len - n, n);
Packit db3073
		  g_array_set_size (result, result->len - 1);
Packit db3073
		}
Packit db3073
	      break;
Packit db3073
	    case 'r':
Packit db3073
	      /* This is a rather odd format. Hard to say what to do.
Packit db3073
	       * Let's always use the POSIX %I:%M:%S %p
Packit db3073
	       */
Packit db3073
#if 1
Packit db3073
	      g_array_append_vals (result, L"12:00:00", 8);
Packit db3073
#else
Packit db3073
	      if (systemtime.wHour == 0)
Packit db3073
		g_array_append_vals (result, L"12", 2);
Packit db3073
	      else
Packit db3073
		{
Packit db3073
		  g_array_append_vals (result, digits + (systemtime.wHour%12)/10, 1);
Packit db3073
		  g_array_append_vals (result, digits + (systemtime.wHour%12)%10, 1);
Packit db3073
		}
Packit db3073
	      g_array_append_vals (result, L":", 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMinute/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMinute%10, 1);
Packit db3073
	      g_array_append_vals (result, L":", 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wSecond/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wSecond%10, 1);
Packit db3073
	      g_array_append_vals (result, L" ", 1);
Packit db3073
#endif
Packit db3073
	      n = GetTimeFormatW (lcid, 0, &systemtime, L"tt", NULL, 0);
Packit db3073
	      if (n > 0)
Packit db3073
		{
Packit db3073
		  g_array_set_size (result, result->len + n);
Packit db3073
		  GetTimeFormatW (lcid, 0, &systemtime, L"tt", ((wchar_t *) result->data) + result->len - n, n);
Packit db3073
		  g_array_set_size (result, result->len - 1);
Packit db3073
		}
Packit db3073
	      break;
Packit db3073
	    case 'R':
Packit db3073
#if 1
Packit db3073
	      g_array_append_vals (result, L"00:00", 5);
Packit db3073
#else
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wHour/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wHour%10, 1);
Packit db3073
	      g_array_append_vals (result, L":", 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMinute/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMinute%10, 1);
Packit db3073
#endif
Packit db3073
	      break;
Packit db3073
	    case 'S':
Packit db3073
#if 1
Packit db3073
	      g_array_append_vals (result, L"00", 2);
Packit db3073
#else
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wSecond/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wSecond%10, 1);
Packit db3073
#endif
Packit db3073
	      break;
Packit db3073
	    case 't':
Packit db3073
	      g_array_append_vals (result, L"\t", 1);
Packit db3073
	      break;
Packit db3073
	    case 'T':
Packit db3073
#if 1
Packit db3073
	      g_array_append_vals (result, L"00:00:00", 8);
Packit db3073
#else
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wHour/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wHour%10, 1);
Packit db3073
	      g_array_append_vals (result, L":", 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMinute/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wMinute%10, 1);
Packit db3073
	      g_array_append_vals (result, L":", 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wSecond/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wSecond%10, 1);
Packit db3073
#endif
Packit db3073
	      break;
Packit db3073
	    case 'u':
Packit db3073
	      if (systemtime.wDayOfWeek == 0)
Packit db3073
		g_array_append_vals (result, L"7", 1);
Packit db3073
	      else
Packit db3073
		g_array_append_vals (result, digits + systemtime.wDayOfWeek, 1);
Packit db3073
	      break;
Packit db3073
	    case 'U':
Packit db3073
	      n = g_date_get_sunday_week_of_year (d);
Packit db3073
	      g_array_append_vals (result, digits + n/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + n%10, 1);
Packit db3073
	      break;
Packit db3073
	    case 'V':
Packit db3073
	      n = g_date_get_iso8601_week_of_year (d);
Packit db3073
	      g_array_append_vals (result, digits + n/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + n%10, 1);
Packit db3073
	      break;
Packit db3073
	    case 'w':
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wDayOfWeek, 1);
Packit db3073
	      break;
Packit db3073
	    case 'W':
Packit db3073
	      n = g_date_get_monday_week_of_year (d);
Packit db3073
	      g_array_append_vals (result, digits + n/10, 1);
Packit db3073
	      g_array_append_vals (result, digits + n%10, 1);
Packit db3073
	      break;
Packit db3073
	    case 'x':
Packit db3073
	      n = GetDateFormatW (lcid, 0, &systemtime, NULL, NULL, 0);
Packit db3073
	      if (n > 0)
Packit db3073
		{
Packit db3073
		  g_array_set_size (result, result->len + n);
Packit db3073
		  GetDateFormatW (lcid, 0, &systemtime, NULL, ((wchar_t *) result->data) + result->len - n, n);
Packit db3073
		  g_array_set_size (result, result->len - 1);
Packit db3073
		}
Packit db3073
	      break;
Packit db3073
	    case 'X':
Packit db3073
	      n = GetTimeFormatW (lcid, 0, &systemtime, NULL, NULL, 0);
Packit db3073
	      if (n > 0)
Packit db3073
		{
Packit db3073
		  g_array_set_size (result, result->len + n);
Packit db3073
		  GetTimeFormatW (lcid, 0, &systemtime, NULL, ((wchar_t *) result->data) + result->len - n, n);
Packit db3073
		  g_array_set_size (result, result->len - 1);
Packit db3073
		}
Packit db3073
	      break;
Packit db3073
	    case 'y':
Packit db3073
	      g_array_append_vals (result, digits + (systemtime.wYear/10)%10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wYear%10, 1);
Packit db3073
	      break;
Packit db3073
	    case 'Y':
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wYear/1000, 1);
Packit db3073
	      g_array_append_vals (result, digits + (systemtime.wYear/100)%10, 1);
Packit db3073
	      g_array_append_vals (result, digits + (systemtime.wYear/10)%10, 1);
Packit db3073
	      g_array_append_vals (result, digits + systemtime.wYear%10, 1);
Packit db3073
	      break;
Packit db3073
	    case 'Z':
Packit db3073
	      n = GetTimeZoneInformation (&tzinfo);
Packit db3073
	      if (n == TIME_ZONE_ID_UNKNOWN)
Packit db3073
		;
Packit db3073
	      else if (n == TIME_ZONE_ID_STANDARD)
Packit db3073
		g_array_append_vals (result, tzinfo.StandardName, wcslen (tzinfo.StandardName));
Packit db3073
	      else if (n == TIME_ZONE_ID_DAYLIGHT)
Packit db3073
		g_array_append_vals (result, tzinfo.DaylightName, wcslen (tzinfo.DaylightName));
Packit db3073
	      break;
Packit db3073
	    case '%':
Packit db3073
	      g_array_append_vals (result, L"%", 1);
Packit db3073
	      break;
Packit db3073
	    }      
Packit db3073
	} 
Packit db3073
      else if (c <= 0xFFFF)
Packit db3073
	{
Packit db3073
	  wchar_t wc = c;
Packit db3073
	  g_array_append_vals (result, &wc, 1);
Packit db3073
	}
Packit db3073
      else
Packit db3073
	{
Packit db3073
	  glong nwc;
Packit db3073
	  wchar_t *ws;
Packit db3073
Packit db3073
	  ws = g_ucs4_to_utf16 (&c, 1, NULL, &nwc, NULL);
Packit db3073
	  g_array_append_vals (result, ws, nwc);
Packit db3073
	  g_free (ws);
Packit db3073
	}
Packit db3073
      p = g_utf8_next_char (p);
Packit db3073
    }
Packit db3073
  
Packit db3073
  convbuf = g_utf16_to_utf8 ((wchar_t *) result->data, result->len, NULL, &convlen, NULL);
Packit db3073
  g_array_free (result, TRUE);
Packit db3073
Packit db3073
  if (!convbuf)
Packit db3073
    {
Packit db3073
      s[0] = '\0';
Packit db3073
      return 0;
Packit db3073
    }
Packit db3073
  
Packit db3073
  if (slen <= convlen)
Packit db3073
    {
Packit db3073
      /* Ensure only whole characters are copied into the buffer. */
Packit db3073
      gchar *end = g_utf8_find_prev_char (convbuf, convbuf + slen);
Packit db3073
      g_assert (end != NULL);
Packit db3073
      convlen = end - convbuf;
Packit db3073
Packit db3073
      /* Return 0 because the buffer isn't large enough. */
Packit db3073
      retval = 0;
Packit db3073
    }
Packit db3073
  else
Packit db3073
    retval = convlen;
Packit db3073
Packit db3073
  memcpy (s, convbuf, convlen);
Packit db3073
  s[convlen] = '\0';
Packit db3073
  g_free (convbuf);
Packit db3073
Packit db3073
  return retval;
Packit db3073
}
Packit db3073
Packit db3073
#endif
Packit db3073
Packit db3073
/**
Packit db3073
 * g_date_strftime:
Packit db3073
 * @s: destination buffer
Packit db3073
 * @slen: buffer size
Packit db3073
 * @format: format string
Packit db3073
 * @date: valid #GDate
Packit db3073
 *
Packit db3073
 * Generates a printed representation of the date, in a
Packit db3073
 * <link linkend="setlocale">locale</link>-specific way.
Packit db3073
 * Works just like the platform's C library strftime() function,
Packit db3073
 * but only accepts date-related formats; time-related formats
Packit db3073
 * give undefined results. Date must be valid. Unlike strftime()
Packit db3073
 * (which uses the locale encoding), works on a UTF-8 format
Packit db3073
 * string and stores a UTF-8 result.
Packit db3073
 *
Packit db3073
 * This function does not provide any conversion specifiers in
Packit db3073
 * addition to those implemented by the platform's C library.
Packit db3073
 * For example, don't expect that using g_date_strftime() would
Packit db3073
 * make the \%F provided by the C99 strftime() work on Windows
Packit db3073
 * where the C library only complies to C89.
Packit db3073
 *
Packit db3073
 * Returns: number of characters written to the buffer, or 0 the buffer was too small
Packit db3073
 */
Packit db3073
gsize     
Packit db3073
g_date_strftime (gchar       *s, 
Packit db3073
                 gsize        slen, 
Packit db3073
                 const gchar *format, 
Packit db3073
                 const GDate *d)
Packit db3073
{
Packit db3073
  struct tm tm;
Packit db3073
#ifndef G_OS_WIN32
Packit db3073
  gsize locale_format_len = 0;
Packit db3073
  gchar *locale_format;
Packit db3073
  gsize tmplen;
Packit db3073
  gchar *tmpbuf;
Packit db3073
  gsize tmpbufsize;
Packit db3073
  gsize convlen = 0;
Packit db3073
  gchar *convbuf;
Packit db3073
  GError *error = NULL;
Packit db3073
  gsize retval;
Packit db3073
#endif
Packit db3073
Packit db3073
  g_return_val_if_fail (g_date_valid (d), 0);
Packit db3073
  g_return_val_if_fail (slen > 0, 0); 
Packit db3073
  g_return_val_if_fail (format != NULL, 0);
Packit db3073
  g_return_val_if_fail (s != NULL, 0);
Packit db3073
Packit db3073
  g_date_to_struct_tm (d, &tm;;
Packit db3073
Packit db3073
#ifdef G_OS_WIN32
Packit db3073
  if (!g_utf8_validate (format, -1, NULL))
Packit db3073
    {
Packit db3073
      s[0] = '\0';
Packit db3073
      return 0;
Packit db3073
    }
Packit db3073
  return win32_strftime_helper (d, format, &tm, s, slen);
Packit db3073
#else
Packit db3073
Packit db3073
  locale_format = g_locale_from_utf8 (format, -1, NULL, &locale_format_len, &error);
Packit db3073
Packit db3073
  if (error)
Packit db3073
    {
Packit db3073
      g_warning (G_STRLOC "Error converting format to locale encoding: %s\n", error->message);
Packit db3073
      g_error_free (error);
Packit db3073
Packit db3073
      s[0] = '\0';
Packit db3073
      return 0;
Packit db3073
    }
Packit db3073
Packit db3073
  tmpbufsize = MAX (128, locale_format_len * 2);
Packit db3073
  while (TRUE)
Packit db3073
    {
Packit db3073
      tmpbuf = g_malloc (tmpbufsize);
Packit db3073
Packit db3073
      /* Set the first byte to something other than '\0', to be able to
Packit db3073
       * recognize whether strftime actually failed or just returned "".
Packit db3073
       */
Packit db3073
      tmpbuf[0] = '\1';
Packit db3073
      tmplen = strftime (tmpbuf, tmpbufsize, locale_format, &tm;;
Packit db3073
Packit db3073
      if (tmplen == 0 && tmpbuf[0] != '\0')
Packit db3073
        {
Packit db3073
          g_free (tmpbuf);
Packit db3073
          tmpbufsize *= 2;
Packit db3073
Packit db3073
          if (tmpbufsize > 65536)
Packit db3073
            {
Packit db3073
              g_warning (G_STRLOC "Maximum buffer size for g_date_strftime exceeded: giving up\n");
Packit db3073
              g_free (locale_format);
Packit db3073
Packit db3073
              s[0] = '\0';
Packit db3073
              return 0;
Packit db3073
            }
Packit db3073
        }
Packit db3073
      else
Packit db3073
        break;
Packit db3073
    }
Packit db3073
  g_free (locale_format);
Packit db3073
Packit db3073
  convbuf = g_locale_to_utf8 (tmpbuf, tmplen, NULL, &convlen, &error);
Packit db3073
  g_free (tmpbuf);
Packit db3073
Packit db3073
  if (error)
Packit db3073
    {
Packit db3073
      g_warning (G_STRLOC "Error converting results of strftime to UTF-8: %s\n", error->message);
Packit db3073
      g_error_free (error);
Packit db3073
Packit db3073
      s[0] = '\0';
Packit db3073
      return 0;
Packit db3073
    }
Packit db3073
Packit db3073
  if (slen <= convlen)
Packit db3073
    {
Packit db3073
      /* Ensure only whole characters are copied into the buffer.
Packit db3073
       */
Packit db3073
      gchar *end = g_utf8_find_prev_char (convbuf, convbuf + slen);
Packit db3073
      g_assert (end != NULL);
Packit db3073
      convlen = end - convbuf;
Packit db3073
Packit db3073
      /* Return 0 because the buffer isn't large enough.
Packit db3073
       */
Packit db3073
      retval = 0;
Packit db3073
    }
Packit db3073
  else
Packit db3073
    retval = convlen;
Packit db3073
Packit db3073
  memcpy (s, convbuf, convlen);
Packit db3073
  s[convlen] = '\0';
Packit db3073
  g_free (convbuf);
Packit db3073
Packit db3073
  return retval;
Packit db3073
#endif
Packit db3073
}