Changed to take a const argument, and then to cast out const.
[platform/upstream/glib.git] / docs / reference / glib / tmpl / date.sgml
index 2137a14..60d0a4d 100644 (file)
@@ -414,6 +414,18 @@ must be valid.
 @n_years: Number of years to move
 
 
+<!-- ##### FUNCTION g_date_days_between ##### -->
+<para>
+Compute the number of days between two dates.
+If @date2 is prior to @date1, the returned value is negative.
+Both dates must be valid.
+</para>
+
+@date1: The first date
+@date2: The second date
+@Returns: The number of days between @date1 and @date2
+
+
 <!-- ##### FUNCTION g_date_compare ##### -->
 <para>\r
 <function>qsort()</function>-style comparsion function for dates. Both\r
@@ -426,6 +438,29 @@ dates must be valid.
 greater than zero if @lhs is greater than @rhs
 
 
+<!-- ##### FUNCTION g_date_clamp ##### -->
+<para>
+If @date is prior to @min_date, set @date equal to @min_date.
+If @date falls after @max_date, set @date equal to @max_date.
+Either @min_date and @max_date may be %NULL.  All non-%NULL dates
+must be valid.
+</para>
+
+@date: Date to clamp
+@min_date: Minimum accepted value for @date
+@max_date: Maximum accepted value for @date
+
+
+<!-- ##### FUNCTION g_date_order ##### -->
+<para>
+Check if @date1 is less than or equal to @date2,
+and swap the values if this is not the case.
+</para>
+
+@date1: The first date
+@date2: The second date
+
+
 <!-- ##### FUNCTION g_date_get_day ##### -->
 <para>\r
 Return the day of the month; the #GDate must be valid.\r