[libgit2.git] / src / util / date.h

/*
 * Copyright (C) the libgit2 contributors. All rights reserved.
 *
 * This file is part of libgit2, distributed under the GNU GPL v2 with
 * a Linking Exception. For full terms see the included COPYING file.
 */
#ifndef INCLUDE_date_h__
#define INCLUDE_date_h__

#include "util.h"
#include "str.h"

/*
 * Parse a string into a value as a git_time_t.
 *
 * Sample valid input:
 * - "yesterday"
 * - "July 17, 2003"
 * - "2003-7-17 08:23"
 */
extern int git_date_parse(git_time_t *out, const char *date);

/*
 * Format a git_time as a RFC2822 string
 *
 * @param out buffer to store formatted date
 * @param time the time to be formatted
 * @param offset the timezone offset
 * @return 0 if successful; -1 on error
 */
extern int git_date_rfc2822_fmt(git_str *out, git_time_t time, int offset);

#endif
Commit	Line	Data
e579e0f7 MB	1	/*
	2	* Copyright (C) the libgit2 contributors. All rights reserved.
	3	*
	4	* This file is part of libgit2, distributed under the GNU GPL v2 with
	5	* a Linking Exception. For full terms see the included COPYING file.
	6	*/
	7	#ifndef INCLUDE_date_h__
	8	#define INCLUDE_date_h__
	9
	10	#include "util.h"
	11	#include "str.h"
	12
	13	/*
	14	* Parse a string into a value as a git_time_t.
	15	*
	16	* Sample valid input:
	17	* - "yesterday"
	18	* - "July 17, 2003"
	19	* - "2003-7-17 08:23"
	20	*/
	21	extern int git_date_parse(git_time_t out, const char date);
	22
	23	/*
	24	* Format a git_time as a RFC2822 string
	25	*
	26	* @param out buffer to store formatted date
	27	* @param time the time to be formatted
	28	* @param offset the timezone offset
	29	* @return 0 if successful; -1 on error
	30	*/
	31	extern int git_date_rfc2822_fmt(git_str *out, git_time_t time, int offset);
	32
	33	#endif