utils: Add GDateTime utils

This will greatly help with the transition to GDateTime. In the future, we can propose these APIs to GLib itself.
2019-04-26 12:59:29 -03:00
parent 3bff2b8981
commit 68943eec57
5 changed files with 164 additions and 2 deletions
@@ -0,0 +1,44 @@
+/* gcal-date-time-utils.h
+ *
+ * Copyright 2019 Georges Basile Stavracas Neto <georges.stavracas@gmail.com>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+#pragma once
+
+#include <glib.h>
+
+G_BEGIN_DECLS
+
+/**
+ * gcal_clear_datetime:
+ * @dt: location of a #GDateTime pointer
+ *
+ * Unreferences @dt if not %NULL, and set it to %NULL.
+ */
+#define gcal_clear_datetime(dt) g_clear_pointer (dt, g_date_time_unref)
+
+gboolean             gcal_set_date_time                          (GDateTime         **dest,
+                                                                  GDateTime          *src);
+
+guint8               gcal_date_time_get_days_in_month            (GDateTime          *date);
+
+GDateTime*           gcal_date_time_get_start_of_week            (GDateTime          *date);
+
+GDateTime*           gcal_date_time_get_end_of_week              (GDateTime          *date);
+
+G_END_DECLS