TextFactory Class Reference

Functionality for working with text. More...

#include <textfactory.h>

Collaboration diagram for TextFactory:

Static Public Member Functions
static bool	isCaseInsensitiveLessThan (const QString &lhs, const QString &rhs)
	Does case-insensitive comparison of two strings. More...
static QDateTime	parseDateTime (const QString &date_time)
	Tries to parse input textual date/time representation. More...
static QDateTime	parseDateTime (qint64 milis_from_epoch)
	Converts 1970-epoch miliseconds to date/time. More...
static QString	shorten (const QString &input, int text_length_limit)
	Shortens input string according to given length limit. More...

Detailed Description

Functionality for working with text.

Definition at line 40 of file textfactory.h.

Member Function Documentation

static bool TextFactory::isCaseInsensitiveLessThan ( const QString &  lhs, const QString &  rhs  )

inlinestatic

Does case-insensitive comparison of two strings.

Parameters

lhs	First string.
rhs	Second string.

Returns

Returns true if lhs is "smaller" than rhs.

Definition at line 50 of file textfactory.h.

                                                                                         {
      return lhs.toLower() < rhs.toLower();
    }

QDateTime TextFactory::parseDateTime ( const QString &  date_time )

static

Tries to parse input textual date/time representation.

Parameters

date_time

String of date/time to parse.

Returns

Returns invalid date/time if processing fails.

Note

This method tries to always return time in UTC+00:00.

Definition at line 43 of file textfactory.cpp.

                                                             {
  QString date = date_time.simplified();
  QStringList date_patterns;
  QStringList timezone_offset_patterns;
  QDateTime dt;
  QTime time_zone_offset;
  QLocale locale(QLocale::C);
  bool positive_time_zone_offset = false;

  date_patterns << "yyyy-MM-ddTHH:mm:ss" << "MMM dd yyyy hh:mm:ss" <<
                   "MMM d yyyy hh:mm:ss" << "ddd, dd MMM yyyy HH:mm:ss" <<
                   "dd MMM yyyy" << "yyyy-MM-dd HH:mm:ss.z" << "yyyy-MM-dd" <<
                   "yyyy" << "yyyy-MM" << "yyyy-MM-dd" << "yyyy-MM-ddThh:mm" <<
                   "yyyy-MM-ddThh:mm:ss";

  timezone_offset_patterns << "+hh:mm" << "-hh:mm" << "+hhmm" << "-hhmm" << "+hh" << "-hh";

  if (date.size() >= 5) {
    foreach (const QString &pattern, timezone_offset_patterns) {
      time_zone_offset = QTime::fromString(date.right(pattern.size()), pattern);

      if (time_zone_offset.isValid()) {
        positive_time_zone_offset = pattern.at(0) == '+';
        break;
      }
    }
  }

  // Iterate over patterns and check if input date/time matches the pattern.
  foreach (const QString &pattern, date_patterns) {
    dt = locale.toDateTime(date.left(pattern.size()), pattern);

    if (dt.isValid()) {
      // Make sure that this date/time is considered UTC.
      dt.setTimeSpec(Qt::UTC);

      if (time_zone_offset.isValid()) {
        // Time zone offset was detected.
        if (positive_time_zone_offset) {
          // Offset is positive, so we have to subtract it to get
          // the original UTC.
          return dt.addSecs(- QTime(0, 0, 0, 0).secsTo(time_zone_offset));
        }
        else {
          // Vice versa.
          return dt.addSecs(QTime(0, 0, 0, 0).secsTo(time_zone_offset));
        }
      }
      else {
        return dt;
      }
    }
  }

  // Parsing failed, return invalid datetime.
  return QDateTime();
}

Here is the caller graph for this function:

QDateTime TextFactory::parseDateTime ( qint64  milis_from_epoch )

static

Converts 1970-epoch miliseconds to date/time.

Parameters

milis_from_epoch

Number of miliseconds.

Returns

This apparently returns date/time in localtime.

Definition at line 101 of file textfactory.cpp.

                                                            {
  return QDateTime::fromMSecsSinceEpoch(milis_from_epoch);
}

QString TextFactory::shorten ( const QString &  input, int  text_length_limit  )

static

Shortens input string according to given length limit.

Parameters

input	Input string.
text_length_limit	Limit length.

Returns

Returns shortened string.

Definition at line 105 of file textfactory.cpp.

                                                                        {
  if (input.size() > text_length_limit) {
    return input.left(text_length_limit - ELLIPSIS_LENGTH) + QString(ELLIPSIS_LENGTH, '.');
  }
  else {
    return input;
  }
}

---

The documentation for this class was generated from the following files:

• textfactory.h
• textfactory.cpp