`sloss_week()`

computes the **weekly sleep loss** for the standard and micro
versions of the Munich Chronotype Questionnaire (MCTQ).

## Arguments

- sd_w
A

`Duration`

object corresponding to the**sleep duration on workdays**from a standard or micro version of the MCTQ questionnaire. You can use`sdu()`

to compute it.- sd_f
A

`Duration`

object corresponding to the**sleep duration on work-free days**from a standard or micro version of the MCTQ questionnaire. You can use`sdu()`

to compute it.- wd
An integerish

`numeric`

object or an`integer`

object corresponding to the**number of workdays per week**from a standard or micro version of the MCTQ questionnaire.

## Details

**Standard MCTQ** functions were created following the guidelines in
Roenneberg, Wirz-Justice, & Merrow (2003), Roenneberg, Allebrandt, Merrow, &
Vetter (2012), and from The Worldwide Experimental Platform (theWeP, n.d.).

**\(\mu\)MCTQ** functions were created following the guidelines in Ghotbi
et al. (2020), in addition to the guidelines used for the standard MCTQ.

**MCTQ\(^{Shift}\)** functions were created following the
guidelines in Juda, Vetter, & Roenneberg (2013), in addition to the
guidelines used for the standard MCTQ.

See the References section to learn more.

### Class requirements

The `mctq`

package works with a set of object classes specially created to
hold time values. These classes can be found in the
lubridate and hms
packages. Please refer to those package documentations to learn more about
them.

### Rounding and fractional time

Some operations may produce an output with fractional time (e.g.,
`"19538.3828571429s (~5.43 hours)"`

, `01:15:44.505`

). If you want, you
can round it with round_time().

Our recommendation is to avoid rounding, but, if you do, make sure that you only round your values after all computations are done. That way you avoid round-off errors.

## Guidelines

Roenneberg, Allebrandt, Merrow, & Vetter (2012) and The Worldwide
Experimental Platform (n.d.) guidelines for `sloss_week()`

(\(SLoss_{week}\)) computation are as follows.

### Notes

If you are visualizing this documentation in plain text (

`ASCII`

), you may have some trouble understanding the equations. If you want a better viewer, you can see this documentation on the package website.

### Computation

**$$\textrm{If } SD_{week} > SD_W \; , \; (SD_{week} - SD_W) \times WD$$**
**$$\textrm{If } SD_{week} \leq SD_W \; , \; (SD_{week} - SD_F) \times
FD$$**

Where:

\(SD_W\) = sleep duration on workdays.

\(SD_F\) = sleep duration on work-free days.

\(SD_{week}\) = average weekly sleep duration.

\(WD\) = number of workdays per week ("I have a regular work schedule and work ___ days per week").

\(FD\) = number of work-free days per week.

***** \(W\) = workdays; \(F\) = work-free days.

## Missing sections in standard and micro MCTQ versions

Although the standard and micro versions of the MCTQ asks for respondents to
complete the workdays and work-free days sections, even when they do not
have a regular work schedule (`wd = 0`

) or have a 7 day/week work schedule
(`wd = 7`

), some of them may still end skipping one of this parts of the
questionnaire. In those cases, `sd_week()`

, `sloss_week()`

, `le_week()`

,
`msf_sc()`

, `sjl_rel()`

, and `sjl()`

will produce `NA`

(Not Available) as
output. That's because those computations combine workdays and work-free days
variables.

For those special standard and micro MCTQ cases, where one section is
missing, a `NA`

value is the correct output for the functions mentioned above
when `wd`

(number of workdays per week) are `wd > 0 & wd < 7`

, but it may not
be when `wd == 0`

or `wd == 7`

. There are different approaches to deal with
this issue. See `vignette("missing-sections", package = "mctq")`

to learn
more.

## References

Ghotbi, N., Pilz, L. K., Winnebeck, E. C., Vetter, C., Zerbini, G., Lenssen,
D., Frighetto, G., Salamanca, M., Costa, R., Montagnese, S., & Roenneberg, T.
(2020). The \(\mu\)MCTQ: an ultra-short version of the Munich ChronoType
Questionnaire. *Journal of Biological Rhythms*, *35*(1), 98-110.
doi: 10.1177/0748730419886986
.

Juda, M., Vetter, C., & Roenneberg, T. (2013). The Munich ChronoType
Questionnaire for shift-workers (MCTQ\(^{Shift}\)). *Journal of
Biological Rhythms*, *28*(2), 130-140. doi: 10.1177/0748730412475041
.

Roenneberg T., Allebrandt K. V., Merrow M., & Vetter C. (2012). Social jetlag
and obesity. *Current Biology*, *22*(10), 939-43.
doi: 10.1016/j.cub.2012.03.038
.

Roenneberg, T., Wirz-Justice, A., & Merrow, M. (2003). Life between clocks:
daily temporal patterns of human chronotypes. *Journal of Biological
Rhythms*, *18*(1), 80-90. doi: 10.1177/0748730402239679
.

The Worldwide Experimental Platform (n.d.). MCTQ. https://www.thewep.org/documentations/mctq/

## Examples

```
## Scalar example
sd_w <- lubridate::dhours(6.5)
sd_f <- lubridate::dhours(7)
wd <- 4
sloss_week(sd_w, sd_f, wd)
#> [1] "3085.71428571429s (~51.43 minutes)"
#> [1] "3085.71428571429s (~51.43 minutes)" # Expected
sd_w <- lubridate::dhours(7)
sd_f <- lubridate::dhours(8)
wd <- 5
sloss_week(sd_w, sd_f, wd)
#> [1] "5142.85714285714s (~1.43 hours)"
#> [1] "5142.85714285714s (~1.43 hours)" # Expected
sd_w <- lubridate::dhours(NA)
sd_f <- lubridate::dhours(9.45)
wd <- 7
sloss_week(sd_w, sd_f, wd)
#> [1] NA
#> [1] NA # Expected
## Vector example
sd_w <- c(lubridate::dhours(7), lubridate::dhours(8))
sd_f <- c(lubridate::dhours(6.5), lubridate::dhours(8))
wd <- c(2, 0)
sloss_week(sd_w, sd_f, wd)
#> [1] "2571.42857142857s (~42.86 minutes)" "0s"
#> [1] "2571.42857142857s (~42.86 minutes)" "0s" # Expected
## Converting the output to `hms`
sd_w <- lubridate::dhours(4)
sd_f <- lubridate::dhours(5)
wd <- 3
x <- sloss_week(sd_w, sd_f, wd)
x
#> [1] "6171.42857142858s (~1.71 hours)"
#> [1] "6171.42857142858s (~1.71 hours)" # Expected
hms::as_hms(as.numeric(x))
#> 01:42:51.428571
#> 01:42:51.428571 # Expected
## Rounding the output at the seconds level
sd_w <- lubridate::dhours(5.8743)
sd_f <- lubridate::dhours(7.4324)
wd <- 6
x <- sloss_week(sd_w, sd_f, wd)
x
#> [1] "4807.85142857144s (~1.34 hours)"
#> [1] "4807.85142857144s (~1.34 hours)" # Expected
round_time(x)
#> [1] "4808s (~1.34 hours)"
#> [1] "4808s (~1.34 hours)" # Expected
```