haiku/docs/user/locale/TimeZone.dox
John Scipione 820dca4df6 Big docs cleanup.
* Fixed headers including:
  - All rights reserved not All Rights Reserved.
  - name, email@domain.com not name <email@domain.com>
  - tabs and spaces
  - Authors: not Documented by:
* Renamed string.dox to String.dox
* Renamed midixxx.dox files to MidiXxx.dox
* Moved images into images subdirectories and updated Doxfile.
* Re-format all files with tabs instead of spaces.
* Fix many spelling mistakes.
* Added all files, classes, structs, and enums to libbe group.
2013-02-07 02:01:19 -05:00

115 lines
2.4 KiB
Plaintext

/*
* Copyright 2011 Haiku, Inc. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
* Adrien Destugues, pulkomandy@pulkomandy.ath.cx
* John Scipione, jscipione@gmail.com
* Oliver Tappe, zooey@hirschkaefer.de
*
* Corresponds to:
* headers/os/locale/TimeZone.h rev 42274
* src/kits/locale/TimeZone.cpp rev 42274
*/
/*!
\file TimeZone.h
\ingroup locale
\ingroup libbe
\brief Provides the BTimeZone class.
*/
/*!
\class BTimeZone
\ingroup locale
\ingroup libbe
\brief Provides information about time zones.
*/
/*!
\fn BTimeZone::BTimeZone(const char* zoneID, const BLanguage* language)
\brief Construct a timezone from its \a zoneID and \a language.
The constructor only allows you to construct a timezone if you already
know its code. If you don't know the code, you can instead go through the
BCountry class which can enumerate all timezones in a country, or use the
BLocaleRoster, which knows the timezone selected by the user.
*/
/*!
\fn BTimeZone::BTimeZone(const BTimeZone& other)
*/
/*!
\fn BTimeZone& BTimeZone::operator=(const BTimeZone& source)
*/
/*!
\fn const BString& BTimeZone::ID() const
\brief Returns the ID of the time zone.
*/
/*!
\fn const BString& BTimeZone::Name() const
\brief Returns the localized name of the time zone.
Use this method to display the time zone's name to the user.
*/
/*!
\fn const BString& BTimeZone::DaylightSavingName() const
\brief Returns the name of the daylight savings rules used in this timezone.
*/
/*!
\fn const BString& BTimeZone::ShortName() const
\brief Returns the short name of the timezone, in the user's locale.
*/
/*!
\fn const BString& BTimeZone::ShortDaylightSavingName() const
\brief Returns the short name of the daylight savings rules used in this
timezone.
*/
/*!
\fn int BTimeZone::OffsetFromGMT() const
\brief Return the offset from GMT.
The offset is a number of seconds, positive or negative.
*/
/*!
\fn bool BTimeZone::SupportsDaylightSaving() const
\brief Return true if the time zone has daylight saving rules
*/
/*!
\fn status_t BTimeZone::InitCheck() const
\brief Return \c false if there was an error creating the timezone
for instance if you called the constructor or SetTo() with an invalid
timezone code.)
*/
/*!
\fn status_t BTimeZone::SetTo(const char* zoneCode)
\brief Set the timezone to another code.
\returns \c false if there was an error (likely due to an invalid
timezone code.)
*/