File: weekly_time_checked.h

package info (click to toggle)
chromium 138.0.7204.183-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,071,908 kB
  • sloc: cpp: 34,937,088; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,953; asm: 946,768; xml: 739,971; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,806; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (91 lines) | stat: -rw-r--r-- 2,994 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
// Copyright 2024 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROMEOS_ASH_COMPONENTS_POLICY_WEEKLY_TIME_WEEKLY_TIME_CHECKED_H_
#define CHROMEOS_ASH_COMPONENTS_POLICY_WEEKLY_TIME_WEEKLY_TIME_CHECKED_H_

#include <array>
#include <optional>

#include "base/component_export.h"
#include "base/time/time.h"
#include "base/values.h"

namespace policy {

// `WeeklyTimeChecked` corresponds to the same type from
// `components/policy/resources/templates/common_schemas.yaml`. It is used to
// read and unpack the policy value into a proper C++ type.
//
// It contains the day of the week (number from 1 to 7; 1 = Monday, 2 = Tuesday,
// etc.) and the time (milliseconds since midnight).
//
// It is different from `WeeklyTime` in that it is checked automatically during
// policy decoding for validity, and it also doesn't have the timezone info
// tacked on top.
class COMPONENT_EXPORT(CHROMEOS_ASH_COMPONENTS_POLICY) WeeklyTimeChecked {
 public:
  // Test support.
  static const char kDayOfWeek[];
  static const char kMillisecondsSinceMidnight[];
  static std::array<const char*, 7> kWeekDays;

  // Explicit numbering because we map 1-to-1 with `WeekDay` from
  // `common_schemas.yaml`.
  // TODO(b/345186543, isandrk): Consider separating `Day` into its own class in
  // a separate file. More type safety and better logical encapsulation.
  enum class Day {
    kMonday = 1,
    kTuesday = 2,
    kWednesday = 3,
    kThursday = 4,
    kFriday = 5,
    kSaturday = 6,
    kSunday = 7,
  };

  static Day NextDay(Day day);

  WeeklyTimeChecked(Day day_of_week, int milliseconds_since_midnight);
  WeeklyTimeChecked(const WeeklyTimeChecked&);
  WeeklyTimeChecked& operator=(const WeeklyTimeChecked&);

  friend bool operator==(const WeeklyTimeChecked&,
                         const WeeklyTimeChecked&) = default;

  // Constructs from a Value::Dict:
  // {
  //   "day_of_week": int,
  //   "milliseconds_since_midnight": int
  // }.
  static std::optional<WeeklyTimeChecked> FromDict(
      const base::Value::Dict& dict);

  // Constructs from an exploded base::Time.
  static WeeklyTimeChecked FromExploded(const base::Time::Exploded& exploded);

  // Constructs from `time` in local time (as opposed to GMT, PST, etc.).
  static WeeklyTimeChecked FromTimeAsLocalTime(base::Time time);

  // Constructs from `time_delta`. Opposite of `ToTimeDelta()`.
  static WeeklyTimeChecked FromTimeDelta(base::TimeDelta time_delta);

  // Convert to base::TimeDelta. (Monday, 0) = 0, (Monday, 5h) = 5h,
  // (Tuesday, 0) = 1d, (Tuesday, 5m) = 1d + 5m, etc.
  base::TimeDelta ToTimeDelta() const;

  Day day_of_week() const { return day_of_week_; }

  int milliseconds_since_midnight() const {
    return milliseconds_since_midnight_;
  }

 private:
  Day day_of_week_;
  int milliseconds_since_midnight_;
};

}  // namespace policy

#endif  // CHROMEOS_ASH_COMPONENTS_POLICY_WEEKLY_TIME_WEEKLY_TIME_CHECKED_H_