Files
XdlOrm/include/QxDao/QxTimeNeutral.h
2026-04-03 11:32:07 +08:00

154 lines
4.7 KiB
C++

/****************************************************************************
**
** https://www.qxorm.com/
** Copyright (C) 2013 XDL Team (ic-east.com)
**
** This file is part of the QxOrm library
**
** This software is provided 'as-is', without any express or implied
** warranty. In no event will the authors be held liable for any
** damages arising from the use of this software
**
** Commercial Usage
** Licensees holding valid commercial QxOrm licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and XDL Team
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file 'license.gpl3.txt' included in the
** packaging of this file. Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met : http://www.gnu.org/copyleft/gpl.html
**
** If you are unsure which license is appropriate for your use, or
** if you have questions regarding the use of this file, please contact :
** ic-east.com
**
****************************************************************************/
#ifndef _QX_TIME_NEUTRAL_H_
#define _QX_TIME_NEUTRAL_H_
#ifdef _MSC_VER
#pragma once
#endif
/*!
* \file QxTimeNeutral.h
* \author XDL Team
* \ingroup QxDao
* \brief Helper class to store a time value into database under neutral format (HHMMSS) => cross database compatibility
*/
#ifdef _QX_ENABLE_BOOST_SERIALIZATION
#include <boost/serialization/serialization.hpp>
#include <boost/serialization/nvp.hpp>
#endif // _QX_ENABLE_BOOST_SERIALIZATION
#include <QtCore/qdatetime.h>
#include <QtCore/qdatastream.h>
#include <QxSerialize/Qt/QxSerialize_QString.h>
#include <QxTraits/get_class_name.h>
namespace qx
{
class QxTimeNeutral;
} // namespace qx
QX_DLL_EXPORT QDataStream &operator<<(QDataStream &stream, const qx::QxTimeNeutral &t) QX_USED;
QX_DLL_EXPORT QDataStream &operator>>(QDataStream &stream, qx::QxTimeNeutral &t) QX_USED;
namespace qx
{
/*!
* \ingroup QxDao
* \brief qx::QxTimeNeutral : helper class to store a time value into database under neutral format (HHMMSS) => cross database compatibility
*/
class QxTimeNeutral
{
#ifdef _QX_ENABLE_BOOST_SERIALIZATION
friend class boost::serialization::access;
#endif // _QX_ENABLE_BOOST_SERIALIZATION
friend QX_DLL_EXPORT QDataStream & ::operator<<(QDataStream &stream, const qx::QxTimeNeutral &t);
friend QX_DLL_EXPORT QDataStream & ::operator>>(QDataStream &stream, qx::QxTimeNeutral &t);
private:
QTime m_time; //!< Data value under QTime format from Qt library
QString m_neutral; //!< Data value under neutral format 'hhmmss'
public:
QxTimeNeutral() { ; }
explicit QxTimeNeutral(const QTime &time) : m_time(time) { update(); }
explicit QxTimeNeutral(const QString &neutral) : m_neutral(neutral) { update(); }
virtual ~QxTimeNeutral() { ; }
inline QTime toTime() const { return m_time; }
inline QString toNeutral() const { return m_neutral; }
inline bool isValid() const { return m_time.isValid(); }
inline void setTime(const QTime &time)
{
m_neutral = "";
m_time = time;
update();
}
inline void setNeutral(const QString &neutral)
{
m_time = QTime();
m_neutral = neutral;
update();
}
static QxTimeNeutral fromTime(const QTime &time) { return QxTimeNeutral(time); }
static QxTimeNeutral fromNeutral(const QString &neutral) { return QxTimeNeutral(neutral); }
private:
static inline const char *format() { return "hhmmss"; }
void update()
{
if (m_neutral.isEmpty() && !m_time.isValid())
{
return;
}
else if (m_time.isValid())
{
m_neutral = m_time.toString(format());
}
else
{
qAssert(m_neutral.size() == QString(format()).size());
m_time = QTime::fromString(m_neutral, format());
qAssert(m_time.isValid());
}
}
#ifdef _QX_ENABLE_BOOST_SERIALIZATION
template <class Archive>
void serialize(Archive &ar, const unsigned int file_version)
{
Q_UNUSED(file_version);
ar &boost::serialization::make_nvp("time_neutral", m_neutral);
if (Archive::is_loading::value)
{
m_time = QTime();
update();
}
}
#endif // _QX_ENABLE_BOOST_SERIALIZATION
};
} // namespace qx
QX_REGISTER_CLASS_NAME(qx::QxTimeNeutral)
#endif // _QX_TIME_NEUTRAL_H_