diff options
author | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2011-11-06 15:56:40 -0600 |
---|---|---|
committer | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2011-11-06 15:56:40 -0600 |
commit | e16866e072f94410321d70daedbcb855ea878cac (patch) | |
tree | ee3f52eabde7da1a0e6ca845fb9c2813cf1558cf /tdecore/krfcdate.h | |
parent | a58c20c1a7593631a1b50213c805507ebc16adaf (diff) | |
download | tdelibs-e16866e072f94410321d70daedbcb855ea878cac.tar.gz tdelibs-e16866e072f94410321d70daedbcb855ea878cac.zip |
Actually move the kde files that were renamed in the last commit
Diffstat (limited to 'tdecore/krfcdate.h')
-rw-r--r-- | tdecore/krfcdate.h | 100 |
1 files changed, 100 insertions, 0 deletions
diff --git a/tdecore/krfcdate.h b/tdecore/krfcdate.h new file mode 100644 index 000000000..ade819622 --- /dev/null +++ b/tdecore/krfcdate.h @@ -0,0 +1,100 @@ +/* + This file is part of the KDE libraries + Copyright (c) 2000 Waldo Bastian <bastian@kde.org> + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License version 2 as published by the Free Software Foundation. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public License + along with this library; see the file COPYING.LIB. If not, write to + the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + Boston, MA 02110-1301, USA. +*/ + +#ifndef _KRFCDATE_H_ +#define _KRFCDATE_H_ + +#include <tqstring.h> +#include <time.h> +#include "kdelibs_export.h" + +/** + * The KRFCDate class contains functions related to the parsing of dates. + * + * @author Waldo Bastian <bastian@kde.org> + */ +class KDECORE_EXPORT KRFCDate +{ +public: + /** + * This function tries to parse a string containing a date/time in any + * of the formats specified by RFC822, RFC850, RFC1036, RFC1123 and RFC2822. + * + * If the date/time could not be parsed, 0 is returned. If the + * parsed date is epoch, then epoch+1 is returned so that a valid + * date will not be confused with an improper date string. + * + * The date/time returned is converted to UTC. + * @param date the date to parse + * @return the date, or 0 if not possible + */ + static time_t parseDate(const TQString &date); + + /** + * This function tries to parse a string containing a date/time in + * any of the formats specified by http://www.w3.org/TR/NOTE-datetime + * + * This is a subset of the formats specified in ISO8601. + * + * If the date/time could not be parsed, 0 is returned. If the + * parsed date is epoch, then epoch+1 is returned so that a valid + * date will not be confused with an improper date string. + * + * The date/time returned is converted to UTC. + * + * @param date the date to parse + * @return the date, or 0 if not possible + */ + static time_t parseDateISO8601(const TQString &date); + + /** + * Returns the local timezone offset to UTC in minutes + * @return the local timezone offset in minutes + */ + static int localUTCOffset(); + + + /** + * Returns a string representation of the given date and time formated + * in conformance to RFC2822. + * + * @param utcTime a date and time in UTC + * @param utcOffset the offset to UTC in minutes + * @return the string representation of the date + */ + + static TQCString rfc2822DateString(time_t utcTime, int utcOffset); + + + /** + * Returns a string representation of the given date and time formated + * in conformance to RFC2822. + * + * Provided for convenience, the function is equivalent to + * rfc2822DateString(t, localUTCOffset()). + * + * @param utcTime a date and time in UTC + * @return the string representation of the date + */ + + static TQCString rfc2822DateString(time_t utcTime); + +}; + +#endif |