| /** |
| * @copyright |
| * ==================================================================== |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| * ==================================================================== |
| * @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. |
| * |
| * @see 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. |
| * |
| * @see svn_time_to_cstring() for the reverse conversion. |
| * |
| * @deprecated Also accepts a format that was used before Subversion 0.14. |
| * See implementation for details. Use of this format is deprecated. |
| * |
| * 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. |
| * |
| * @deprecated Provided for backward compatibility with the 1.5 API. |
| * Use svn_io_sleep_for_timestamps() instead. |
| */ |
| SVN_DEPRECATED |
| void |
| svn_sleep_for_timestamps(void); |
| |
| #ifdef __cplusplus |
| } |
| #endif /* __cplusplus */ |
| |
| #endif /* SVN_TIME_H */ |