75 lines
2.4 KiB
C
75 lines
2.4 KiB
C
/**
|
||
* @copyright
|
||
* ====================================================================
|
||
* Copyright (c) 2000-2004 CollabNet. All rights reserved.
|
||
*
|
||
* This software is licensed as described in the file COPYING, which
|
||
* you should have received as part of this distribution. The terms
|
||
* are also available at http://subversion.tigris.org/license-1.html.
|
||
* If newer versions of this license are posted there, you may use a
|
||
* newer version instead, at your option.
|
||
*
|
||
* This software consists of voluntary contributions made by many
|
||
* individuals. For exact contribution history, see the revision
|
||
* history and logs, available at http://subversion.tigris.org/.
|
||
* ====================================================================
|
||
* @endcopyright
|
||
*
|
||
* @file svn_time.h
|
||
* @brief Time/date utilities
|
||
*/
|
||
|
||
#ifndef SVN_TIME_H
|
||
#define SVN_TIME_H
|
||
|
||
#include <apr_pools.h>
|
||
#include <apr_time.h>
|
||
|
||
#include "svn_error.h"
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif /* __cplusplus */
|
||
|
||
|
||
/** Convert @a when to a <tt>const char *</tt> representation allocated
|
||
* in @a pool. Use svn_time_from_cstring() for the reverse
|
||
* conversion.
|
||
*/
|
||
const char *svn_time_to_cstring(apr_time_t when, apr_pool_t *pool);
|
||
|
||
/** Convert @a data to an @c apr_time_t @a when.
|
||
* Use @a pool for temporary memory allocation.
|
||
*/
|
||
svn_error_t *svn_time_from_cstring(apr_time_t *when, const char *data,
|
||
apr_pool_t *pool);
|
||
|
||
/** Convert @a when to a <tt>const char *</tt> representation allocated
|
||
* in @a pool, suitable for human display in UTF8.
|
||
*/
|
||
const char *svn_time_to_human_cstring(apr_time_t when, apr_pool_t *pool);
|
||
|
||
|
||
/** Convert a human-readable date @a text into an @c apr_time_t, using
|
||
* @a now as the current time and storing the result in @a result.
|
||
* The local time zone will be used to compute the appropriate GMT
|
||
* offset if @a text contains a local time specification. Set @a
|
||
* matched to indicate whether or not @a text was parsed successfully.
|
||
* Perform any allocation in @a pool. Return an error iff an internal
|
||
* error (rather than a simple parse error) occurs.
|
||
*/
|
||
svn_error_t *
|
||
svn_parse_date(svn_boolean_t *matched, apr_time_t *result, const char *text,
|
||
apr_time_t now, apr_pool_t *pool);
|
||
|
||
|
||
/** Sleep until the next second, to ensure that any files modified
|
||
* after we exit have a different timestamp than the one we recorded.
|
||
*/
|
||
void svn_sleep_for_timestamps(void);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif /* __cplusplus */
|
||
|
||
#endif /* SVN_TIME_H */
|