~testplan-team/testplan/source-collection

<DT><PRE>public class DateUtil<DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></DL>

</PRE>

100

101

102

A utility class for parsing and formatting HTTP dates as used in cookies and

103

other headers. This class handles dates as defined by RFC 2616 section

104

3.3.1 as well as some other common non-standard formats.

105

106

107

108

<DL>

109

<DT>Author:</DT>

110

<DD>Christopher Brown, Michael Becke</DD>

111

</DL>

112

<HR>

113

114

115

116

117

118

119

120

121

Field Summary</TH>

122

</TR>

123

124

125

<CODE>static <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></TD>

126

<TD><CODE><A HREF="../../../../../org/apache/commons/httpclient/util/DateUtil.html#PATTERN_ASCTIME">PATTERN_ASCTIME</A></CODE>

127

128

129

          Date format pattern used to parse HTTP date headers in ANSI C

130

<code>asctime()</code> format.</TD>

131

</TR>

132

133

134

<CODE>static <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></TD>

135

<TD><CODE><A HREF="../../../../../org/apache/commons/httpclient/util/DateUtil.html#PATTERN_RFC1036">PATTERN_RFC1036</A></CODE>

136

137

138

Date format pattern used to parse HTTP date headers in RFC 1036 format.</TD>

139

</TR>

140

141

142

<CODE>static <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></TD>

143

<TD><CODE><A HREF="../../../../../org/apache/commons/httpclient/util/DateUtil.html#PATTERN_RFC1123">PATTERN_RFC1123</A></CODE>

144

145

146

Date format pattern used to parse HTTP date headers in RFC 1123 format.</TD>

147

</TR>

148

</TABLE>

149

150

151

152

153

154

155

156

Method Summary</TH>

157

</TR>

158

159

160

<CODE>static <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></TD>

161

<TD><CODE><A HREF="../../../../../org/apache/commons/httpclient/util/DateUtil.html#formatDate(java.util.Date)">formatDate</A>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A> date)</CODE>

162

163

164

Formats the given date according to the RFC 1123 pattern.</TD>

165

</TR>

166

167

168

<CODE>static <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></TD>

169

<TD><CODE><A HREF="../../../../../org/apache/commons/httpclient/util/DateUtil.html#formatDate(java.util.Date, java.lang.String)">formatDate</A>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A> date,

170

<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> pattern)</CODE>

171

172

173

Formats the given date according to the specified pattern.</TD>

174

</TR>

175

176

177

<CODE>static <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A></CODE></TD>

178

<TD><CODE><A HREF="../../../../../org/apache/commons/httpclient/util/DateUtil.html#parseDate(java.lang.String)">parseDate</A>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> dateValue)</CODE>

179

180

181

Parses a date value.</TD>

182

</TR>

183

184

185

<CODE>static <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A></CODE></TD>

186

<TD><CODE><A HREF="../../../../../org/apache/commons/httpclient/util/DateUtil.html#parseDate(java.lang.String, java.util.Collection)">parseDate</A>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> dateValue,

187

<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> dateFormats)</CODE>

188

189

190

Parses the date value using the given date formats.</TD>

191

</TR>

192

193

194

<CODE>static <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A></CODE></TD>

195

<TD><CODE><A HREF="../../../../../org/apache/commons/httpclient/util/DateUtil.html#parseDate(java.lang.String, java.util.Collection, java.util.Date)">parseDate</A>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> dateValue,

196

<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> dateFormats,

197

<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A> startDate)</CODE>

198

199

200

Parses the date value using the given date formats.</TD>

201

</TR>

202

</TABLE>

203

204

205

206

<TH ALIGN="left">Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></TH>

207

</TR>

208

209

<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>

210

</TR>

211

</TABLE>

212

213

214

215

216

217

218

219

220

221

Field Detail</TH>

222

</TR>

223

</TABLE>

224

225

226

PATTERN_RFC1123</H3>

227

<PRE>

228

public static final <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> PATTERN_RFC1123</PRE>

229

<DL>

230

<DD>Date format pattern used to parse HTTP date headers in RFC 1123 format.

231

232

<DL>

233

<DT>See Also:<DD><A HREF="../../../../../constant-values.html#org.apache.commons.httpclient.util.DateUtil.PATTERN_RFC1123">Constant Field Values</A></DL>

234

</DL>

235

<HR>

236

237

238

PATTERN_RFC1036</H3>

239

<PRE>

240

public static final <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> PATTERN_RFC1036</PRE>

241

<DL>

242

<DD>Date format pattern used to parse HTTP date headers in RFC 1036 format.

243

244

<DL>

245

<DT>See Also:<DD><A HREF="../../../../../constant-values.html#org.apache.commons.httpclient.util.DateUtil.PATTERN_RFC1036">Constant Field Values</A></DL>

246

</DL>

247

<HR>

248

249

250

PATTERN_ASCTIME</H3>

251

<PRE>

252

public static final <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> PATTERN_ASCTIME</PRE>

253

<DL>

254

<DD>Date format pattern used to parse HTTP date headers in ANSI C

255

<code>asctime()</code> format.

256

257

<DL>

258

<DT>See Also:<DD><A HREF="../../../../../constant-values.html#org.apache.commons.httpclient.util.DateUtil.PATTERN_ASCTIME">Constant Field Values</A></DL>

259

</DL>

260

261

262

263

264

265

266

267

Method Detail</TH>

268

</TR>

269

</TABLE>

270

271

272

parseDate</H3>

273

<PRE>

274

public static <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A> parseDate(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> dateValue)

275

throws <A HREF="../../../../../org/apache/commons/httpclient/util/DateParseException.html" title="class in org.apache.commons.httpclient.util">DateParseException</A></PRE>

276

<DL>

277

<DD>Parses a date value. The formats used for parsing the date value are retrieved from

278

the default http params.

279

280

281

<DT>Parameters:<DD><CODE>dateValue</CODE> - the date value to parse

282

<DT>Returns:<DD>the parsed date

283

<DT>Throws:

284

<DD><CODE><A HREF="../../../../../org/apache/commons/httpclient/util/DateParseException.html" title="class in org.apache.commons.httpclient.util">DateParseException</A></CODE> - if the value could not be parsed using any of the

285

supported date formats</DL>

286

</DD>

287

</DL>

288

<HR>

289

290

291

parseDate</H3>

292

<PRE>

293

294

<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> dateFormats)

295

throws <A HREF="../../../../../org/apache/commons/httpclient/util/DateParseException.html" title="class in org.apache.commons.httpclient.util">DateParseException</A></PRE>

296

<DL>

297

<DD>Parses the date value using the given date formats.

298

299

300

<DT>Parameters:<DD><CODE>dateValue</CODE> - the date value to parse<DD><CODE>dateFormats</CODE> - the date formats to use

301

<DT>Returns:<DD>the parsed date

302

<DT>Throws:

303

304

</DD>

305

</DL>

306

<HR>

307

308

309

parseDate</H3>

310

<PRE>

311

312

<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A> dateFormats,

313

<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A> startDate)

314

throws <A HREF="../../../../../org/apache/commons/httpclient/util/DateParseException.html" title="class in org.apache.commons.httpclient.util">DateParseException</A></PRE>

315

<DL>

316

<DD>Parses the date value using the given date formats.

317

318

319

<DT>Parameters:<DD><CODE>dateValue</CODE> - the date value to parse<DD><CODE>dateFormats</CODE> - the date formats to use<DD><CODE>startDate</CODE> - During parsing, two digit years will be placed in the range

320

<code>startDate</code> to <code>startDate + 100 years</code>. This value may

321

be <code>null</code>. When <code>null</code> is given as a parameter, year

322

<code>2000</code> will be used.

323

<DT>Returns:<DD>the parsed date

324

<DT>Throws:

325

326

</DD>

327

</DL>

328

<HR>

329

330

331

formatDate</H3>

332

<PRE>

333

public static <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> formatDate(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Date.html" title="class or interface in java.util">Date</A> date)</PRE>

334

<DL>

335

<DD>Formats the given date according to the RFC 1123 pattern.

336

337

338

<DT>Parameters:<DD><CODE>date</CODE> - The date to format.

339

<DT>Returns:<DD>An RFC 1123 formatted date string.<DT>See Also:<DD><A HREF="../../../../../org/apache/commons/httpclient/util/DateUtil.html#PATTERN_RFC1123"><CODE>PATTERN_RFC1123</CODE></A></DL>

340

</DD>

341

</DL>

342

<HR>

343

344

345

formatDate</H3>

346

<PRE>

347

348

<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> pattern)</PRE>

349

<DL>

350

<DD>Formats the given date according to the specified pattern. The pattern

351

must conform to that used by the <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html" title="class or interface in java.text"><CODE>simple date

352

format</CODE></A> class.

353

354

355

<DT>Parameters:<DD><CODE>date</CODE> - The date to format.<DD><CODE>pattern</CODE> - The pattern to use for formatting the date.

356

<DT>Returns:<DD>A formatted date string.

357

<DT>Throws:

358

<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - If the given date pattern is invalid.<DT>See Also:<DD><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html" title="class or interface in java.text"><CODE>SimpleDateFormat</CODE></A></DL>

359

</DD>

360

</DL>

361

362

<HR>

363

364

365

366

367

368

369

<TR>

370

371

372

373

374

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html">Overview</A> </TD>

375

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html">Package</A> </TD>

376

<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev">  Class </TD>

377

378

379

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html">Deprecated</A> </TD>

380

<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html">Index</A> </TD>

381

382

</TR>

383

</TABLE>

384

</TD>

385

386

387

</TD>

388

</TR>

389

390

<TR>

391

392

<A HREF="../../../../../org/apache/commons/httpclient/util/DateParser.html" title="class in org.apache.commons.httpclient.util">PREV CLASS</A>

393

<A HREF="../../../../../org/apache/commons/httpclient/util/EncodingUtil.html" title="class in org.apache.commons.httpclient.util">NEXT CLASS</A></TD>

394

395

<A HREF="../../../../../index.html?org/apache/commons/httpclient/util/DateUtil.html" target="_top">FRAMES</A>

396

<A HREF="DateUtil.html" target="_top">NO FRAMES</A>

397

398

<!--

399

if(window==top) {

400

document.writeln('<A HREF="../../../../../allclasses-noframe.html">All Classes</A>');

401

}

402

//-->

403

</SCRIPT>

404

405

<A HREF="../../../../../allclasses-noframe.html">All Classes</A>

406

</NOSCRIPT>

407

408

409

</TD>

410

</TR>

411

<TR>

412

413

SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></TD>

414

415

DETAIL: <A HREF="#field_detail">FIELD</A> | CONSTR | <A HREF="#method_detail">METHOD</A></TD>

416

</TR>

417

</TABLE>

418

419

420

421

<HR>

422

423

</BODY>

424

</HTML>

Older »