svn_time.h File Reference

Time/date utilities. More...

`#include <apr_pools.h>`
`#include <apr_time.h>`
`#include "svn_error.h"`

Go to the source code of this file.

## Functions

const char * | svn_time_to_cstring (apr_time_t when, apr_pool_t *pool)
| Convert when to a `const char *` representation allocated in pool. More...
svn_error_t * | svn_time_from_cstring (apr_time_t *when, const char *data, apr_pool_t *pool)
| Convert data to an `apr_time_t` when. More...
const char * | svn_time_to_human_cstring (apr_time_t when, apr_pool_t *pool)
| Convert when to a `const char *` representation allocated in pool, suitable for human display in UTF8.
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)
| Convert a human-readable date text into an `apr_time_t`, using now as the current time and storing the result in result. More...
void | svn_sleep_for_timestamps (void)
| Sleep until the next second, to ensure that any files modified after we exit have a different timestamp than the one we recorded. More...

## Detailed Description

Time/date utilities.

# @if copyrights

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.

Definition in file svn_time.h.

## Function Documentation

## svn_parse_date()

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
| ) |  |

Convert a human-readable date text into an `apr_time_t`, using now as the current time and storing the result in result.

The local time zone will be used to compute the appropriate GMT offset if text contains a local time specification. Set matched to indicate whether or not text was parsed successfully. Perform any allocation in pool. Return an error iff an internal error (rather than a simple parse error) occurs.

## svn_sleep_for_timestamps()

void svn_sleep_for_timestamps | ( | void |  | ) |

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_time_from_cstring()

svn_error_t* svn_time_from_cstring | ( | apr_time_t * | when,
|  | const char * | data,
|  | apr_pool_t * | pool
| ) |  |

Convert data to an `apr_time_t` when.

See also
  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 pool for temporary memory allocation.

## svn_time_to_cstring()

const char* svn_time_to_cstring | ( | apr_time_t | when,
|  | apr_pool_t * | pool
| ) |  |

Convert when to a `const char *` representation allocated in pool.

See also
  svn_time_from_cstring() for the reverse conversion.