This is really a deprecated function. It is still present for backward compatibility. No enhancements are planned for this function.
If it's deprecated, why is it still being used in 18 different files in Seamonkey? If it's just for backward compatibility, why are even new extensions such as P3P using it? Could it be that you consider it deprecated and maybe even have a replacement for it, but word hasn't got through to Seamonkey folks? If so, some evangelizing might be appropriate. If not, I disagree with marking WONTFIX.
It would be helpful to know why this was deprecated, and what existing callers are supposed to do now. Could this information at least be added to the comments in prtime.h, so that folks stumbling on this function via lxr and other places won't be tempted to use it?
PR_ParseTimeString() is not documented in the NSPR Reference ( http://www.mozilla.org/projects/nspr/reference/html/index.html ). It was left in the headers and source for backward compatibility. The source for the function says that only a limited number of timezones are recognized.
After reading chapter 14 of the above, it appears to me that NSPR does provide fcts to convert PRTime (ticks since epoch) into PRExplodedTime (struct representing year, month, day, ...) and vice versa, but no fctn that converts a time string into PRExplodedTime (similar to PR_ParseTimeString). Could it be that you declared PR_ParseTimeString deprecated without providing a substitute?
larryh: well, the current header file commentary and lack of reference guide mention doesn't seem to have been sufficient to prevent people from continuing to use it. It seems as though adding "DEPRECATED" loudly in the header file would at least be a step in the right direction. Also, can you shed some light on why it was deprecated? Thanks! nils: if you could file a separate bug on what to do about the SeaMonkey call-sites, that would be great.
Why was PR_ParseTimeString() deprecated? Good question. Frankly, I don't recall. Alas, I recall participating in the discussion, but for the life of me, I can't remember the content. ... a bad case of CRS. That's what happens when you get old, or something.
Dan: I filed bug 90631 about removing PR_ParseTimeString() from Seamonkey. To close this matter, can we agree to shift the focus of this bug to adding the documentation that Dan mentioned? I would also suggest to add a note that there's no official replacement provided.
See related bugzilla: 90631. Marking WontFix again.
I can't find a replacement for this function ? Is there a similar function at all ? I need it for SQL database support I work on Thanks
*** Bug 180912 has been marked as a duplicate of this bug. ***